Double-click any Markdown file and read it formatted — or press Space in Finder and never open the app at all. Native, offline, read-only on purpose.
One-time purchase · macOS 14+ · Apple Silicon and Intel
An MD viewer is a macOS app that opens a Markdown (.md) file and renders it as a formatted document — headings, tables, code blocks and diagrams instead of raw syntax. Unlike a Markdown editor, it does not write to the file: it only displays it.
That distinction is the whole point. Most tools that rank for this search are editors — Typora, MacDown, iA Writer — and they open with a cursor in your document. If you only need to read a file somebody sent you, or that a tool generated, an editor is a heavier answer than the question deserves.
The fastest way to read Markdown on a Mac is not to open an app. MacMD Viewer registers a Quick Look provider, so Space renders the file where it sits.
Direct download or Homebrew. The Quick Look extension ships with it — there is nothing separate to install.
System Settings > Privacy & Security > Extensions > Quick Look, then tick MacMD Viewer.
In Finder, on the Desktop, in Spotlight results or in an Open dialog. The file renders in place — headings, tables, code, Mermaid.
More detail on the extension: Finder Quick Look preview
Save the file in your editor, or let a coding agent rewrite it, and the rendered view updates. The source stays read-only here.
Flowcharts, sequence, class, ER and Gantt diagrams render inline — in the app and in the Finder preview, offline.
Default, GitHub and Serif in light and dark, plus Sepia, Solarized Light, Dracula, Nord, Tokyo Night and Atom One Dark. The Quick Look preview follows your pick.
Point the Library at a docs or project folder and move between files without going back to Finder. Document outline for long pages.
Coding agents and chat assistants write Markdown by default — specs, plans, summaries, READMEs land in your project folder as .md files. Opening them in a code editor means reading the syntax; opening them in a browser means a round trip through some paste box.
Point the Library at the folder instead. Files render as they land, live reload picks up each rewrite, and you read the document rather than the markup. Half the people who buy MacMD Viewer are not developers — they arrived here holding a .md file that something else produced.
brew install --cask macmd-viewerSigned and notarised .dmg, universal for Apple Silicon and Intel, macOS 14 Sonoma and later — download it here.
They do exist, and for reading the occasional file they are enough. The honest answer is what happens once .md files stop being occasional.
I tried at least 5 similar Apps from the App Store and I was really upset about the poor output quality they produced. So when I came across MacMD I was hesitant at first, but I am so glad I went for it.5/5
The free Quick Look extensions stop at the Finder panel. There is no app to open, no folder to browse, no outline to jump through on a long document.
Point the Library at a project or documentation folder and move between files without going back to Finder each time.
12 document themes, and the Finder preview renders in whichever one you picked — not a separate, unstyled render path.
MacDown, one of the most-recommended free options, has not shipped since 2020 and has no Apple Silicon native build. Releases here are dated in the changelog.
One payment, one Mac, every future update — no subscription and no tier above this one. If you would rather weigh it against the free options first, the comparison is written out in full rather than summarised here.
MacMD Viewer vs QLMarkdown · Compared against 11 Mac Markdown apps · Release history
I am not a developer and don't have other software on my computer besides TextEdit to work with MD files. Diving into the AI vibe coding world though... this app is awesome and a great addition to my toolset.5/5
Simple, fast, and exactly what you want when you double click on a .md file.5/5
I use MacMD Viewer to look at all the MD files Claude Code generates.4/5
Three ways. Press Space on the file in Finder if you have a Quick Look extension installed — the fastest route, no app opens. Double-click it if you have set a dedicated viewer as the default handler for .md files. Or open it in a text editor, which shows the raw ## and | table | syntax rather than the formatted document.
macOS opens .md files in TextEdit by default, which shows the raw Markdown source rather than a rendered document — and pressing Space in Finder gives you the same plain text. macOS has no built-in Markdown renderer, so reading a formatted .md file means installing something.
Yes — QLMarkdown is a free open-source Quick Look extension, and Readdown is a free read-only viewer. Both render a single file well. Where they stop is everything around the file: no window for browsing a folder of docs, no outline on a long document, no theme shared between the app and the Finder preview. MacMD Viewer ($19.99 one-time) is for the point where .md files stopped being occasional.
A viewer. It renders Markdown and never writes to your file — there is no edit mode and nothing to save. Write in whatever tool you already use; read the result here. If you want an app that does both, this is the wrong one.
Yes — a native SwiftUI app, universal for Apple Silicon and Intel, on macOS 14 Sonoma and later.
$19.99 once, for one Mac at a time. No subscription, no trial, no free tier. There is a 14-day money-back guarantee.
One purchase, one Mac, every future update. Native SwiftUI on macOS 14 and later.
14-day money-back guarantee · One-time purchase, no subscription