Every Markdown file, one spacebar away.
PreviewMD renders .md files right in Finder’s Quick Look — press space and read, no app launch, no waiting. Open one properly and you get a live split editor with GitHub-flavored rendering, math and diagrams.
This page is the app. On the left, text as it is rendered. On the right, the Markdown it came from — the same split the app puts on your screen. The switch above works on this page, not on a picture of one.
Free · macOS 14 Sonoma+ · iPadOS & iOS 17+
Everything a README throws at it.
Rendering matches GitHub, so the file you wrote for a repo looks the way you meant it to. Nothing is fetched while it renders: the whole engine ships inside the app, which is why Quick Look is instant and why it works on a plane.
Quick Look in Finder
Press space on any .md file and read it rendered — plus document-style thumbnails in icon and gallery views. The one thing most Markdown tools on the Mac still miss.
GitHub-flavored
Tables, task lists, footnotes, strikethrough, alert callouts ([!NOTE], [!WARNING]) and :emoji:, with syntax highlighting across almost two hundred languages.
Math that typesets
KaTeX renders $inline$ and $$display$$ — fractions, integrals, matrices and aligned equations, not a picture of them.
Mermaid diagrams
Flowcharts, sequence, class, state, pie and gantt charts drawn straight from fenced mermaid blocks, in light and dark to match your screen.
Four ways to work
Preview to read, Split to write beside a live preview, Source for the text alone, and Diff for what changed. Switch with ⌘1–⌘4; Diff greys out when there is nothing to show.
Export and print
A self-contained HTML file, or a PDF always rendered in clean light mode whatever your screen is doing. Printing paginates properly.
Every earlier draft, without a repository.
macOS already keeps revisions of your documents. PreviewMD puts them in a sidebar: pick one and the Diff view shows exactly what changed, word by word. No repo to set up, nothing to commit, no habit to keep.
- Compare against when you opened the file or the last save — and on the Mac, any revision the system kept
- Word-level highlighting, side by side or inline
- Restore an older version into the document — the file on disk only changes when you save
- Diff greys out when the document hasn’t changed, so it never sends you to an empty screen
And when something else edits the file while it is open — a git pull, a sync client, another editor — the window says so instead of quietly overwriting it, and whichever version you don’t take is filed under Earlier versions.
The same app on all three
Split view on the Mac, the diff on iPad, and the rendered page in your pocket.



Questions people actually ask
Does it open files from Obsidian, Bear or a GitHub checkout?
Yes. They are ordinary .md files and PreviewMD leaves them where they are. It imports nothing, moves nothing and keeps no vault of its own — open a file, read or edit it, close it. Wiki links written as [[note]] show up as plain text, because they mean nothing outside the app that invented them.
Does Quick Look work without the app running?
Yes, after the first launch. The system registers the extension, and from then on the spacebar renders Markdown in Finder, in Spotlight results and in a mail attachment — whether or not PreviewMD is open.
What about .markdown, .mdown or .txt?
The common Markdown extensions all open. Plain .txt is deliberately left alone: most text files are not Markdown, and taking over every one of them on a Mac would be rude.
Can it export to PDF?
Yes, and the PDF is always typeset in light mode however your screen is set, because a dark page prints as a black rectangle. Export to a single self-contained HTML file is there too — styles and images in one file you can send to someone who has no Markdown reader at all.
Does it render math and diagrams offline?
Yes. KaTeX and Mermaid are bundled, so nothing leaves the device and nothing is fetched while a document renders. That is also why Quick Look has no loading state.
Is it really free, and what is the catch?
It is free on all three platforms, with no account, no in-app purchase and no telemetry. The catch, if it is one: it is a reader and an editor for Markdown files, not a note system, a sync service or a place to keep your writing.
Where do my files go?
Nowhere. They stay where you put them, on disk or in iCloud Drive, and the app has no server to send them to. The only network access it makes is loading images your own document points at.
Does it work on iPad and iPhone?
The same app, the same rendering, nothing extra to buy. The iPad and iPhone versions open documents from Files and iCloud Drive and edit them in place, with a formatting bar above the keyboard.
Can it replace my editor?
For reading and for quick edits, often yes. For a long writing session with plugins, snippets and a vault full of backlinks, no — and that is not what it is for. It is the app that makes the Markdown you already have readable everywhere on your Mac.
Which languages does it speak?
Nine: English, Czech, German, French, Spanish, Italian, Japanese, Simplified Chinese and Korean. The app follows your system language.
Free. Forever.
No accounts, no upgrade prompts, no usage caps. One app for Mac, iPad and iPhone — free on all three.
- Quick Look previews and Finder thumbnails
- Split editor, live preview, and Diff on every platform
- Math, Mermaid diagrams and code highlighting
- PDF and HTML export, paginated printing
Why free? Because a reader should be. PreviewMD sits beside the other apps in the family, and Markdown is read by everyone who writes code or keeps notes — charging for the reading would be charging for the file format.