claude-code - 💡(How to fix) Fix File viewer in desktop app shows raw markdown instead of rendered formatting [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
anthropics/claude-code#49353Fetched 2026-04-17 08:43:36
View on GitHub
Comments
0
Participants
1
Timeline
3
Reactions
0
Author
Participants
Timeline (top)
labeled ×3

The file viewer in the Claude Code desktop app shows .md files as raw text, including visible #, **, and other markdown syntax. There doesn't appear to be a setting to toggle rendered formatting.

Root Cause

A large share of what Claude Code reads, writes, and displays is markdown: session outputs, agent reports, PRDs, READMEs, design docs. For many workflows the file viewer is the first place a user reviews what Claude has produced. Displaying raw markdown there makes the output harder to skim and review, and often sends users out to a second editor (VS Code, Cursor, Obsidian) just to read a file the desktop app already knows how to open.

Given that the preview pane already renders HTML, PDFs, and images, rendered markdown in the file viewer feels like a natural extension.

Fix Action

Fix / Workaround

Current workaround

RAW_BUFFERClick to expand / collapse

Summary

The file viewer in the Claude Code desktop app shows .md files as raw text, including visible #, **, and other markdown syntax. There doesn't appear to be a setting to toggle rendered formatting.

Why this matters

A large share of what Claude Code reads, writes, and displays is markdown: session outputs, agent reports, PRDs, READMEs, design docs. For many workflows the file viewer is the first place a user reviews what Claude has produced. Displaying raw markdown there makes the output harder to skim and review, and often sends users out to a second editor (VS Code, Cursor, Obsidian) just to read a file the desktop app already knows how to open.

Given that the preview pane already renders HTML, PDFs, and images, rendered markdown in the file viewer feels like a natural extension.

Request

Add rendered markdown display for .md and .markdown files in the desktop app's file viewer. Ideally with a toggle between rendered and raw views, since editing tasks still benefit from seeing raw syntax.

Current workaround

Right-click → Open in → external editor. Works but breaks flow, especially when reviewing multiple files Claude has written.

Environment

  • Claude Code desktop app (macOS)

extent analysis

TL;DR

Implementing a markdown rendering feature in the Claude Code desktop app's file viewer is likely the most effective fix.

Guidance

  • Investigate existing rendering libraries or frameworks that can be integrated into the desktop app to support markdown rendering.
  • Consider adding a toggle feature to switch between rendered and raw views for markdown files, catering to both reading and editing use cases.
  • Review the current implementation of the preview pane, which already renders HTML, PDFs, and images, to identify potential similarities or synergies with markdown rendering.
  • Evaluate the feasibility of leveraging the existing "Open in external editor" workaround as a temporary solution until a native rendering feature is developed.

Example

No code snippet is provided due to the lack of specific technical details in the issue.

Notes

The solution may require significant development effort, and the feasibility of integrating a markdown rendering library or framework into the existing desktop app architecture should be carefully assessed.

Recommendation

Apply a workaround by using an external editor for markdown files until a native rendering feature is implemented, as it currently provides a functional, albeit inconvenient, solution.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

claude-code - 💡(How to fix) Fix File viewer in desktop app shows raw markdown instead of rendered formatting [1 participants]