Where does the bug appear (feature/product)?
Cursor IDE
Describe the Bug
In Cursor Markdown preview, internal anchor links in a README Table of Contents do not navigate to headings in the same file. Cursor appears to treat links as filesystem paths/directories instead of in-document anchors.
Steps to Reproduce
Open a markdown file with headings and TOC links:
Table of Contents
Data Note
Open Cursor markdown preview.
Click the TOC link (#data-note).
Expected Behavior
Preview scrolls/navigates to the ## Data Note heading in the same document.
Operating System
MacOS
Version Information
Cursor (latest as of Apr 15, 2026)
macOS (Darwin 25.3.0)
File: README.md
For AI issues: which model did you use?
Opus 4.6
Additional Information
Full bug report:
Title
Markdown preview in Cursor does not resolve internal TOC links (#anchor) correctly
Summary
In Cursor Markdown preview, internal anchor links in a README Table of Contents do not navigate to headings in the same file. Cursor appears to treat links as filesystem paths/directories instead of in-document anchors.
Environment
Cursor (latest as of Apr 15, 2026)
macOS (Darwin 25.3.0)
File: README.md
Repro steps
Open a markdown file with headings and TOC links:
Table of Contents
Data Note
Open Cursor markdown preview.
Click the TOC link (#data-note).
Expected behavior
Preview scrolls/navigates to the ## Data Note heading in the same document.
Actual behavior
Link does not navigate as an in-document anchor.
Cursor appears to interpret it like a path target.
Additional notes
Tried workaround links like ./README.md#data-note; Cursor then reports it cannot find README.md in preview.
Same markdown links work in GitHub and standard Markdown renderers.
Impact
TOCs are effectively unusable in Cursor preview for longer docs, reducing docs navigation and maintainability.
Does this stop you from using Cursor
No - Cursor works, but with this issue