microsoft / microsoft/TypeScript-TmLanguage

Incorrect JSDoc markdown url syntax highlight

Open
#1,074 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
TypeScript
Stars
471
Forks
149
PR merge metrics
No merged PRs in 30d

Description

Does this issue occur when all extensions are disabled?: Yes

  • VS Code Version: 1.119.0
  • OS Version: MacOS 26.4.1

Steps to Reproduce:

  1. Create a jsdoc or tsdoc with a @see markdown url, like:
/**
 * Some text
 * 
 * @see [Some URL](https://google.com/)
 */
function test() {}
  1. Observe syntax highlight of first [ bracket
Image

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Reproduce the issue in a TypeScript or JavaScript JSDoc comment using the shown @see Markdown URL example, with extensions disabled. Inspect the TypeScript TextMate grammar responsible for JSDoc highlighting and compare the highlighting of the opening bracket with the rest of the link. Done means the opening bracket is highlighted consistently with the Markdown URL syntax.

Written by the indexing model from the issue text.

Assessment

Tech stack
typescript
Domain
tooling
Issue type
Bug
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
55/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.