# Makrdown Preview is broken

**URL:** <https://forum.cursor.com/t/makrdown-preview-is-broken/164460>\
**Category:** Bug Reports\
**Created:** [June 30, 2026, 5:46pm UTC](https://forum.cursor.com/t/makrdown-preview-is-broken/164460 "2026-06-30T17:46:46Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![salehk](https://sea3.discourse-cdn.com/cursor1/user_avatar/forum.cursor.com/salehk/32/97852_2.png) [@salehk](https://forum.cursor.com/u/salehk)\
**Post date:** [June 30, 2026, 5:46pm UTC](https://forum.cursor.com/t/makrdown-preview-is-broken/164460/1 "2026-06-30T17:46:46Z")

</div>

### 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

---

<div class="post-metadata">

**Author:** ![salehk](https://sea3.discourse-cdn.com/cursor1/user_avatar/forum.cursor.com/salehk/32/97852_2.png) [@salehk](https://forum.cursor.com/u/salehk)\
**Post date:** [June 30, 2026, 6:10pm UTC](https://forum.cursor.com/t/makrdown-preview-is-broken/164460/5 "2026-06-30T18:10:30Z")

</div>

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?

---

<div class="post-metadata">

**Author:** ![kevinn](https://sea3.discourse-cdn.com/cursor1/user_avatar/forum.cursor.com/kevinn/32/101206_2.png) [@kevinn](https://forum.cursor.com/u/kevinn)\
**Post date:** [June 30, 2026, 6:34pm UTC](https://forum.cursor.com/t/makrdown-preview-is-broken/164460/7 "2026-06-30T18:34:32Z")

</div>

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.

---

<div class="post-metadata">

**Author:** ![salehk](https://sea3.discourse-cdn.com/cursor1/user_avatar/forum.cursor.com/salehk/32/97852_2.png) [@salehk](https://forum.cursor.com/u/salehk)\
**Post date:** [June 30, 2026, 7:00pm UTC](https://forum.cursor.com/t/makrdown-preview-is-broken/164460/8 "2026-06-30T19:00:48Z")

</div>

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

---

<div class="post-metadata">

**Author:** ![system](https://sea3.discourse-cdn.com/cursor1/user_avatar/forum.cursor.com/system/32/99069_2.png) [@system](https://forum.cursor.com/u/system)\
**Post date:** [July 2, 2026, 7:01pm UTC](https://forum.cursor.com/t/makrdown-preview-is-broken/164460/9 "2026-07-02T19:01:21Z")

</div>

Closed on July 2, 2026, 7:01pm UTC

This topic was automatically closed 2 days after the last reply. New replies are no longer allowed.