How to Preview Markdown on Mac: Every Method Compared
Every way to preview rendered markdown on macOS — Quick Look, VS Code, Terminal tools, browser extensions, and dedicated editors. Which is fastest, which renders the most, and which one to pick.
Short answer: The fastest way to preview markdown on Mac is a dedicated editor like OpenMark — open the file and it renders immediately. For a quick glance without opening anything, a Quick Look plugin like QLMarkdown lets you press Space in Finder. VS Code's built-in preview works but requires the app to be open. Terminal users can pipe markdown through glow or bat for rendered output in the shell.
You've got a .md file. You want to see what it looks like rendered — headings formatted, tables aligned, code blocks highlighted, maybe even diagrams drawn. macOS doesn't render markdown natively (Finder's Quick Look shows raw text by default), so you need a tool. Here's every option, what each one handles, and which to use when.
Option 1: Quick Look Plugin (Fastest for Glancing)
Finder's Quick Look (press Space on a selected file) is the fastest way to preview any file on Mac. By default, .md files show as raw text — you see the ## and ** symbols. But you can fix this with a Quick Look plugin.
QLMarkdown is the best option. Install it via Homebrew:
brew install --cask qlmarkdown
After installation, selecting a .md file in Finder and pressing Space shows the rendered output — headings, bold, lists, code blocks, tables, and even syntax highlighting in code fences.
What it handles: Standard markdown, GFM tables, task lists, code blocks with syntax highlighting, footnotes.
What it doesn't: Mermaid diagrams, LaTeX math, interactive checkboxes. Quick Look plugins render static HTML — anything that requires JavaScript execution won't work.
Best for: Quickly scanning a file without opening it. You're browsing a folder of documentation and want to glance at each file's contents. Press Space, read, press Space again to dismiss.
Option 2: VS Code Preview (If You Already Use VS Code)
VS Code has a built-in markdown preview. Open any .md file and press ⌘⇧V to open a rendered preview in a new tab, or ⌘K V to open a side-by-side preview next to your source.
The built-in preview handles standard markdown well: headings, lists, tables, code blocks, links, images. For anything beyond that, you need extensions:
- Markdown Preview Mermaid Support — renders Mermaid diagrams in the preview pane
- Markdown+Math — renders LaTeX math expressions
- Markdown Preview Enhanced — a full replacement that adds diagrams, math, slide presentations, and more
What it handles (with extensions): Nearly everything. VS Code's extension ecosystem can render almost any markdown variant.
What it doesn't: It's slow to launch if VS Code isn't already open. The preview pane competes for screen space with the editor, file tree, terminal, and status bar. And it's an Electron app — 400MB+ of memory for a text preview.
Best for: Developers who already have VS Code running and want a quick preview without leaving their editor. Not ideal for just reading a file you received.
Option 3: Terminal Rendering (For CLI Workflows)
If you live in the terminal, there are tools that render markdown directly in your shell.
glow is the standout. Install via Homebrew:
brew install glow
Then run:
glow README.md
It renders headings, bold, italic, lists, code blocks, and tables with colors and formatting directly in your terminal. It even has a built-in pager for scrolling through long documents, and a "stash" feature for bookmarking files you read often.
bat is another option. It's primarily a cat replacement with syntax highlighting, so it shows the markdown source with colors rather than rendering it — but it makes raw markdown much more readable than plain cat.
bat README.md
What they handle: Standard markdown formatting. glow renders tables and handles word wrapping. Neither renders Mermaid diagrams or LaTeX math.
Best for: Scanning README files in project directories, reading documentation during development, or piping markdown content through a rendering step in a script.
Option 4: Browser-Based Preview
You can convert markdown to HTML and view it in a browser. There are a few ways:
Grip (GitHub Readme Instant Preview) serves a local preview that matches GitHub's rendering exactly:
brew install grip
grip README.md
This opens localhost:6419 in your browser with a GitHub-styled rendered view. It uses GitHub's API for rendering, so it handles everything GitHub supports — including task lists, emoji shortcodes, and syntax-highlighted code blocks.
The catch: it requires an internet connection (it calls GitHub's API), and it has a rate limit of 60 requests per hour without authentication.
Marked 2 (paid, $13.99) is a standalone preview app that watches a file and updates in real time. Open your .md file in any editor, and Marked 2 shows the rendered output in a separate window. It supports custom CSS, table of contents generation, and export to PDF/HTML/DOCX.
Best for: When you need pixel-perfect GitHub rendering (use grip), or when you want a live-updating preview alongside any editor (use Marked 2).
Option 5: A Dedicated Markdown Editor (Best Overall)
A dedicated markdown editor gives you the rendered preview as the default view. You open the file, you see it rendered. No extensions, no terminal commands, no browser setup.
OpenMark opens any .md file and renders it immediately in a native macOS window — proper typography, formatted tables, syntax-highlighted code blocks, and support for Mermaid diagrams and LaTeX math out of the box. Double-click to switch to the source editor when you need to make changes.
Because it's a native macOS app (SwiftUI, not Electron), it launches fast, uses minimal memory, and integrates with macOS features like Spotlight, the share sheet, and system-wide keyboard shortcuts.
What it handles: Everything — standard markdown, GFM tables, task lists with interactive checkboxes, fenced code blocks with syntax highlighting, Mermaid diagrams (flowcharts, sequence diagrams, Gantt charts), LaTeX math (inline and display), images, footnotes, and all common markdown extensions.
Best for: Anyone who regularly reads or writes markdown files. It's the difference between previewing markdown and living in it.
Comparison
| Method | Launch speed | Rendering | Mermaid/Math | Editing | Cost |
|---|---|---|---|---|---|
| Quick Look (QLMarkdown) | Instant (Space bar) | Good | No | No | Free |
| VS Code | Slow (if not open) | Good + extensions | With extensions | Full editor | Free |
| glow (Terminal) | Instant | Basic | No | No | Free |
| grip (Browser) | Medium | GitHub-exact | No | No | Free |
| Marked 2 | Fast | Good | Limited | No (preview only) | $13.99 |
| OpenMark | Fast | Full | Yes | Full editor | $9.99 |
Which Should You Use?
If you just need a quick glance at a file in Finder, install QLMarkdown. It takes thirty seconds and makes Quick Look useful for markdown.
If you're a developer who already has VS Code open all day, the built-in preview (plus a couple of extensions) is fine for occasional previewing.
If you work with markdown files regularly — reading documentation, reviewing AI-generated output, editing READMEs, writing notes — a dedicated editor is worth it. You wouldn't read PDFs by opening them in a hex editor. Markdown files deserve a proper reader too.
Download OpenMark → — $9.99, one-time, native macOS. Open any .md file and see it rendered instantly. Mermaid diagrams, LaTeX math, interactive checkboxes, and four built-in themes.