Markdown Reader for Mac

macOS doesn't include a built-in Markdown reader. When you double-click a .md file, it opens in TextEdit as raw source — you see # Heading instead of a formatted heading. If you work with READMEs, documentation, or technical notes, you need a proper Markdown reader to make those files readable.

Quick Look — The Built-in Option

macOS Quick Look (press Space on a selected file in Finder) can preview many file types, but it shows .md files as plain text by default. You can install a Quick Look extension to render Markdown, but the experience is limited:

• No table of contents or navigation
• No editing capability
• No Git integration
• Extension quality varies and some break with macOS updates

Quick Look is fine for a glance at a short file, but for anything longer than a page, a dedicated Markdown reader is faster and more comfortable. See our Markdown preview guide for more on Quick Look setup.

Terminal-Based Readers

Command-line tools like glow and bat render Markdown in the terminal. They're useful if you're already in a terminal session:

• glow README.md — renders Markdown with colors and formatting in the terminal
• bat README.md — shows the file with syntax highlighting (but doesn't render Markdown)

Terminal readers work for quick checks, but lack features like clickable links, images, table of contents, and proper table rendering.

VS Code and IDE Preview

Most code editors include a Markdown preview pane. In VS Code, open a .md file and press ⌘ShiftV to see the rendered output side by side.

This works, but it means launching a full IDE just to read a file. VS Code takes several seconds to start and uses hundreds of megabytes of RAM — overkill when all you want is to read a README.

MDViewer — A Dedicated Markdown Reader for Mac

MDViewer is a native macOS app built specifically for reading Markdown. It launches instantly, uses minimal memory, and includes features designed for reading workflows:

• Instant launch — opens in under a second, even on older Macs
• Smart table of contents — auto-generated from headings, tracks your scroll position, highlights the active section
• Inline editing — double-click any word to edit, press ⌘S to save. No mode switching
• Git history — browse file revisions and view color-coded diffs without opening a terminal
• Tabs — open multiple files in one window, switch between them like browser tabs
• Default app integration — set MDViewer as your default .md app so every Markdown file opens from Finder or open README.md in the terminal

Built with SwiftUI — not Electron. Native fonts, system dark mode, smooth scrolling, and a fraction of the memory footprint of IDE-based previews.

How to Set Up MDViewer as Your Default Markdown Reader

1. Download MDViewer and drag it to your Applications folder
2. Right-click any .md file in Finder → Get Info
3. Under "Open with", select MDViewer
4. Click "Change All..." to make it the default for all .md files

From now on, double-clicking any Markdown file opens it in MDViewer. You can also open files from the terminal with open README.md.

Requires macOS 13.0 or later. Intel and Apple Silicon.

Markdown Reader Comparison