Best CLAUDE.md Viewer for Mac (2026)
The best ways to read CLAUDE.md and other Claude Code files on Mac, rendered with tables, Mermaid and code. Compared options, free and paid.
Last reviewed: 2026-10-28. We make OpenMark, so weigh the recommendation accordingly; the table below sticks to facts from each vendor's own documentation.
Short answer: The best way to view a CLAUDE.md file on Mac is with a native markdown viewer like OpenMark. It renders the headings, tables, code blocks, and nested structure as a formatted document — instead of the raw symbols you see in TextEdit.
If you use Claude Code, you have a CLAUDE.md file in your project. It's the configuration file that tells Claude Code about your project — tech stack, conventions, commands, and rules. It's also one of the most structurally complex markdown files you'll encounter, full of tables, code fences, nested lists, and multi-level headings.
Opening it in the right viewer makes a real difference in how quickly you can read and understand it.
Why CLAUDE.md Needs a Proper Viewer
Most markdown files are simple — headings, paragraphs, maybe a list. CLAUDE.md files are different. A typical one includes:
- Tables comparing tools, conventions, or rules
- Code blocks with bash commands, config snippets, and file paths
- Multi-level headings organizing sections like Project Structure, Dev Commands, and Critical Rules
- Inline code for file names, flags, and technical terms
- Nested lists with indented sub-items
When you open a CLAUDE.md in TextEdit, you see all of this as raw symbols: | pipes for tables, triple backticks for code blocks, ## for headings. It's technically readable, but it's slow and error-prone — especially for tables, which become nearly impossible to parse as raw text.
A markdown viewer renders all of this into a properly formatted document. Tables become actual tables. Code blocks get syntax highlighting. Headings create visual hierarchy. You can scan the whole file in seconds instead of minutes.
How to Open CLAUDE.md on Mac
Option 1: OpenMark (Recommended)
OpenMark is a native macOS markdown editor built specifically for opening and reading .md files. It renders CLAUDE.md files with:
- Formatted tables with proper column alignment
- Syntax-highlighted code blocks
- Rendered headings with visual hierarchy
- Inline code styling
- Support for Mermaid diagrams and LaTeX math (if your
CLAUDE.mdincludes them)
It's a native SwiftUI app (about 8 MB), works offline with no account, and has a Quick Look extension, so pressing Space on a CLAUDE.md in Finder shows a rendered preview. Quick Look cannot run JavaScript, so Mermaid diagrams and math show as source there and render in the app. Open a .md file and it appears rendered in Document view; switch to Markdown view with ⌘⇧M when you need to edit.
OpenMark is $9.99 on the Mac App Store — one purchase for Mac, iPhone, and iPad.
Option 2: VS Code
If you already use VS Code, open CLAUDE.md and press ⇧⌘V to toggle the Markdown preview (⌘K V opens it side by side). According to the VS Code Markdown documentation, the built-in preview also renders Mermaid diagrams in mermaid fenced code blocks, with no extension needed.
VS Code works well when you're already in your editor. The preview is a secondary pane inside a code editor rather than a standalone reader, and it doesn't give you a Finder Quick Look preview.
Option 3: GitHub
If your project is on GitHub, navigating to the CLAUDE.md file in the web interface will render it automatically. GitHub also renders Mermaid diagrams in Markdown files, per its diagram documentation. The limitation is that the file has to be pushed, and you need to be online and open it in a browser.
Option 4: TextEdit (Not Recommended)
Markdown is plain text, so a plain-text view such as TextEdit's shows the file as written, without rendering it. You'll see raw | pipes instead of tables, ## instead of headings, and triple backticks instead of code blocks. For a simple README this might be fine, but for the structured complexity of a CLAUDE.md, it's not a good experience.
Comparison: ways to read CLAUDE.md on Mac
| Option | Shows rendered output | Mermaid in CLAUDE.md | Finder Space-bar preview | Price / setup |
|---|---|---|---|---|
| OpenMark | Yes (Document view) | Yes, offline | Yes (Quick Look extension) | $9.99 once, Mac + iPhone + iPad |
| VS Code preview | Yes (⇧⌘V) | Yes, built in (per VS Code docs) | No | Install VS Code; check code.visualstudio.com for current pricing |
| GitHub (web) | Yes, in the browser | Yes (per GitHub docs) | No | Needs the file pushed to a repo and an internet connection |
| TextEdit or any plain-text view | No, raw symbols | No | No | Already on your Mac |
Facts about other products come from their own documentation, linked above, and were checked on 2026-10-28. Prices change, so confirm on each vendor's site.
For a quick read with no install, open or paste a CLAUDE.md in the online Markdown viewer. It renders in your browser and nothing is uploaded.
What to Look For in a CLAUDE.md Viewer
Not every markdown viewer handles CLAUDE.md equally well. Here's what matters:
| Feature | Why It Matters for CLAUDE.md |
|---|---|
| Table rendering | CLAUDE.md files often have comparison tables and structured data |
| Code block highlighting | Bash commands and config snippets need to be readable |
| File association | Double-click to open without choosing an app every time |
| Fast launch | You open CLAUDE.md frequently — startup time matters |
| Native macOS | Integrates with Finder, Spotlight, Quick Look |
How to Set Your Viewer as the Default for .md Files
Once you've picked a viewer, set it as the default so every .md file opens in it automatically:
- Find any
.mdfile in Finder - Right-click → Get Info (or press
⌘I) - Under Open with, select your viewer
- Click Change All… to apply to all
.mdfiles
For a detailed walkthrough, see our Set as Default guide.
Summary
CLAUDE.md is one of the most important files in your project when you're using Claude Code, and it deserves better than raw text in TextEdit. A dedicated markdown viewer like OpenMark renders it as a properly formatted document — tables, code blocks, headings, and all — so you can read and update it quickly.
Frequently asked questions
- What is the best way to view a CLAUDE.md file on Mac?
- A native Markdown viewer such as OpenMark, which we make, so weigh that. It renders headings, tables and code blocks in Document view and has a Quick Look extension, so pressing Space on a CLAUDE.md in Finder shows a rendered preview (diagrams and math show as source there). It costs $9.99 once.
- Can I view CLAUDE.md without installing anything?
- Yes. If the file is on GitHub, opening it in the web interface renders it. You can also open or paste it into the online Markdown viewer on this site, which renders in your browser and uploads nothing.
- Does the VS Code preview render CLAUDE.md?
- Yes. Open the file in Visual Studio Code and press Shift-Command-V to show the Markdown preview, or Command-K then V to open it side by side. VS Code documentation says the built-in preview also renders Mermaid diagrams in mermaid code blocks.
- Why is CLAUDE.md hard to read in TextEdit?
- TextEdit shows Markdown as plain text, so tables appear as rows of pipe characters, headings as ## and code blocks as triple backticks. CLAUDE.md files often contain tables, code blocks and nested lists, which are much easier to scan once rendered.