Makrdown Preview is broken

Support Bug Reports
1

Where does the bug appear (feature/product)?

Cursor IDE

Describe the Bug

Markdown Preview functionality is broken, when clicking on Preview screen flashes and nothing loads

Steps to Reproduce

Open a markdown file in your IDE, in the top switch to “Preview” markdown preview should appear but it doesnt

Expected Behavior

Rendered markdown should appear

Operating System

MacOS

Version Information

Version: 3.9.16
VS Code Extension API: 1.105.1
Commit: 042b3c1a4c53f2c3808067f519fbfc67b72cad80
Date: 2026-06-27T06:41:01.941Z
Layout: editor
Build Type: Stable
Release Track: Default
Electron: 40.10.3
Chromium: 144.0.7559.236
Node.js: 24.15.0
V8: 14.4.258.32-electron.0
xterm.js: 6.1.0-beta.256
OS: Darwin arm64 24.3.0

Does this stop you from using Cursor

No - Cursor works, but with this issue

5

I noticed that this is mainly an issue with large markdown files, it is not effecting all my markdown files. Is this a known issue and a sign I need to break up or shrink our main repo Readme.md?

7

Hi @salehk Thanks for the post and sorry for the inconvenience.

This is a known issue with Cursor’s built-in Preview tab, and we’re tracking it. It usually isn’t a strict size limit, so you shouldn’t need to shrink your README. The built-in Preview is Cursor’s own renderer (separate from VS Code’s Markdown: Open Preview) and can go blank on certain markdown patterns. Longer files are just more likely to contain one of those patterns.

Reliable workaround for now: open the README and run Markdown: Open Preview from the Command Palette (Command+Shift+P to open Command Palette) or press Cmd+Shift+V. That uses a different renderer and isn’t affected.

8

Thank you for the quick response, Kevin. The workaround works!