gajus/eslint-plugin-jsdoc

Rule suggestion: enforce proper `@see` + `@link` syntax for hyperlinks

クローズ

#1,631 opened on 2026/01/20

 (1 件のコメント) (4 件のリアクション) (0 人の担当者)JavaScript (176 件のフォーク)github user discovery
enhancementhelp wanted

Repository metrics

Stars
 (1,227 個のスター)
PR merge metrics
 (平均マージ 2d 8h) (30d で 10 merged PRs)

説明

Motivation

As of filing, I know of two syntaxes for saying a user can @see a link:

  • At-Linked: @see {@link https://example.com|Example}
  • Markdown: @see [Example](https://example.com)

For consistency's sake, I think it would be nice to have a lint rule to prefer one and auto-fix the other to it.

Current behavior

No lint rule enforces either.

Desired behavior

I'm not sure. The Markdown variant is fewer characters, but the At-Linked one seems to be more of a "proper" link through JSDoc @link, so perhaps that?

Both show up well in at least TypeScript's native intellisense. The Markdown variant isn't perfectly supported by VS Code's native syntax highlighter, but that strikes me as a bug and not a motivator for choosing one over the other.

Alternatives considered

🤷

コントリビューターガイド