Markdown Quick Look for Mac
Preview Markdown in Finder. Just press Space.
Imark adds a Markdown Quick Look extension to macOS. Select a .md file in Finder and press the Space bar to read the rendered document without opening an editor.
macOS 14+ · 5.8 MB
Updated
How to preview a Markdown file with Quick Look
The extension registers after Imark has been placed in Applications and opened once.
Install Imark
Move Imark to the Applications folder and open it once.
Select a Markdown file
Click any .md or .markdown file in Finder.
Press the Space bar
Quick Look opens a formatted, scrollable preview.
A real preview, not raw source
Quick Look uses the same renderer as the Imark window. Headings, lists, tables, task lists, highlighted code, Mermaid diagrams, and KaTeX maths appear as a document instead of punctuation-heavy source text.
Designed for a fast Finder workflow
You do not need to open an app first or import the file into a library. Browse a folder, press Space, read, and move to the next file. The preview stays local and does not upload the document.
If the preview does not appear
Confirm that Imark is in Applications and has been opened at least once. If another Markdown Quick Look extension is active, turn off the other extension in System Settings, then try the file again.
Questions
What people want to know.
Does macOS preview Markdown by default?
macOS can show the raw text of many files, but a rendered Markdown Quick Look preview requires an extension such as the one included with Imark.
Does Quick Look work without an internet connection?
Yes. Imark bundles its Markdown renderer, code highlighting, Mermaid, and KaTeX, so previews work offline.
Can Quick Look show local images?
Imark renders compatible images referenced by the Markdown document when macOS grants the extension access to them.
Keep exploring Imark
Open .md files on Mac
How to Open Markdown Files on Mac
Open .md files on Mac as rendered documents. Compare TextEdit, editor previews, Quick Look, and a dedicated Markdown viewer such as Imark.
Read the guideTechnical Markdown
Markdown Viewer with Mermaid and KaTeX for Mac
Read Markdown with Mermaid diagrams, KaTeX maths, syntax-highlighted code, tables, and local images in a private offline Mac app.
Read the guideRead Markdown like a document.
Download Imark for a focused Markdown viewer built for Mac, Finder, and local files.
Download for macOS