Best CLAUDE.md Viewer for Mac: Open and Read It Properly
The best apps to view CLAUDE.md files on Mac. See rendered tables, headings, and code blocks instead of raw markdown symbols. Compare TextEdit, VS Code, and dedicated viewers.
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 SwiftUI app — launches instantly, uses ~8 MB of memory, and integrates with Finder and Spotlight. Double-click any .md file and it opens rendered. Toggle to code view 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 for development, you can open CLAUDE.md and press ⌘⇧V to open the markdown preview. It renders tables, code blocks, and headings, though the preview opens in a separate tab rather than replacing the raw view.
VS Code works well if you're already in your editor. The downside is that it's an Electron app (~350 MB), and the preview is a secondary feature rather than the primary interface.
Option 3: GitHub
If your project is on GitHub, navigating to the CLAUDE.md file in the web interface will render it automatically. GitHub's markdown renderer handles tables, code blocks, and headings well. The limitation is that you need to be online and navigate to the file through a browser.
Option 4: TextEdit (Not Recommended)
TextEdit can open CLAUDE.md since it's a plain text file, but it won't render any markdown formatting. 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.
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.