Best Markdown Viewer for Mac (2026): 16 Apps Compared

You have a .md file, a README, a spec or a plan your AI agent just wrote, and you want to read it formatted instead of squinting at # and *. Most "best Markdown app" lists mix editors and readers, which is how people end up launching a full writing app to read one page.

I build MacMD Viewer, one of the apps below, so weigh my ranking with that in mind. I say when a free app is enough, and I quote the complaints people make about mine.

TL;DR: If you mostly read Markdown that someone or something else wrote, pick a read-only viewer; if you write more than you read, pick an editor such as Typora or Obsidian.

• Best if a coding agent writes your Markdown, or you read it all day: MacMD Viewer ($19.99 once, the app I build). Every plan, spec or report that Claude Code, Cursor or Windsurf writes opens rendered by itself, without pausing the agent, and the app can't change the file.
• Best free reader: Imark (free, open source): Space bar preview in Finder, Mermaid diagrams, live reload, and an optional plan review where the agent waits for your approval. Markdown Preview, Readdown and QuickMD are close behind.
• Same trio, no price listed: MDV, from the developer of Itsycal, is a direct download.
• Best if you write in another editor: Marked 3, a preview companion with proofreading and export.

Every price and version below was re-read at its source on October 20, 2026, and every feature comes from the developer's own site, store listing, README or public reviews. The method is in the "How I checked" section near the end.

Which Markdown viewer should you pick on Mac?#

Pick by what you do with Markdown, not by the longest feature list. Two questions settle it: do you want a reader or an editor, and free or paid?

If you…	Pick	Why
read what your coding agent writes, or long docs every day	MacMD Viewer ($19.99)	each file the agent writes opens rendered by itself, read-only, one-time price
read .md files now and then and want free	Imark or Readdown	Quick Look, Mermaid and live reload at no cost
write in Vim, BBEdit or another editor and need proofing or export	Marked 3	built as a live preview next to your editor
only want a formatted Space bar preview in Finder	QLMarkdown (free) or Marked QL ($9.99)	a Quick Look extension, no reading window needed
write Markdown more than you read it	Typora or Obsidian	they are editors first

If you only need to open one file right now, the steps are in how to open a .md file on Mac.

Mac Markdown viewers compared: the full table#

"Not claimed" means the developer does not advertise the feature on its site or store listing. It does not mean the app lacks it: I did not install and test the competing apps for this comparison.

App	Price	Quick Look	Mermaid	Live reload	Opens agent files	macOS min	Type
MacMD Viewer	$19.99 once	Yes	Yes	Yes	Yes	14	Reader
MDV	No price listed	Yes	Yes	Yes	Not claimed	13	Reader
Imark	Free (MIT)	Yes	Yes	Yes	Plan review instead	14	Reader with edit mode
Readdown	Free	Yes	Yes	Yes	Not claimed	13	Reader
Markdown Preview	Free (MIT)	Yes	Yes	Not claimed	Not claimed	15	Reader with edit mode
QuickMD	Free (MIT)	Not claimed	Yes	Yes	Not claimed	13	Reader with source edit
Marked 3	$2.99/mo or $69.99 once (intro)	Separate app	Yes	Yes	Watches a folder	12.4	Preview companion
Telescopo	7-day trial, then $49.99 once	Not claimed	Yes	Yes	Not claimed	15	Reader and editor
MD-Viewer	Free, ad-supported	Not claimed	Not claimed	Not claimed	Not claimed	10.13	Reader
MarkView	Free	Not claimed	Not claimed	Not claimed	Not claimed	Not stated	Reader
QLMarkdown	Free (GPL-3.0)	Yes, only	Yes	n/a	n/a	Not stated	Quick Look extension
Marked QL	$9.99 once	Yes, only	Yes	n/a	n/a	13	Quick Look extension
Typora	$14.99 once	No	Yes	Editor	Editor	Not stated	WYSIWYG editor
Obsidian	Free, paid Sync	No	Yes	Editor	Editor	Not stated	Notes app
VS Code	Free	No	Yes (1.121+)	Editor	Editor	Not stated	Code editor
MarkViewer	Free	Not claimed	Yes	Yes	Not claimed	10.15	WYSIWYG editor

The best dedicated Markdown readers for Mac#

A dedicated reader opens a local .md file formatted and stays out of your way. Ten apps in this comparison are built mainly for that job.

MacMD Viewer ($19.99): best for reading Markdown every day#

MacMD Viewer is a read-only Markdown viewer for Mac: it renders Markdown, code with syntax highlighting and Mermaid diagrams, and it never writes to your file. The bundled Finder Quick Look extension previews any .md file when you press Space, in whichever of the 12 document themes you picked in the app. Once you run the setup from the integrations guide, every Markdown file that Claude Code, Cursor or Windsurf writes or edits opens in MacMD Viewer by itself: the hook launches the app and the agent carries on without waiting. The open document reloads when an editor or agent saves it again, a document outline sidebar helps in long specs, and File → Export as PDF keeps Mermaid diagrams and highlighted code. Tabs are optional: turn them on in Settings if you want several files in one window.

Best for: people who read Markdown written by someone or something else, all day. Limits: it is not an editor, and one licence covers one Mac at a time. Updates: eleven releases shipped between July 17 and October 16, 2026 (changelog); one buyer wrote on Trustpilot that "I asked for tabs and frontmatter and within 3 days they were shipped" (review, August 2, 2026). Price: $19.99 once, no subscription. It needs macOS 14 Sonoma or later and runs on Apple Silicon and Intel. The features, price and licence above are those of the version on the site and Homebrew (brew install --cask macmd-viewer). It is also available on Setapp.

MDV: the same Finder preview from the Itsycal developer#

MDV comes from Mowglii, the developer of Itsycal. Its site lists a bundled Quick Look extension, Mermaid diagrams, math rendering, a table of contents sidebar, document search, a file watcher that updates as you edit, and a command line tool called mdv.

Best for: readers who want Finder preview plus a terminal command. Limits: it ships as a direct DMG with no Homebrew cask, and the site shows no price. Version: 1.1.13, macOS 13 or later.

Developer site: mowglii.com/mdv

Imark (free): best free reader, but very young#

Imark is free and open source under the MIT licence. Its README lists a Quick Look extension, Mermaid diagrams, math rendering and live reload when your editor saves. It also has an edit mode, and it can keep review notes inside the .md file. Its optional plugin for Claude Code and Codex is a plan review: /imark:imark-review PLAN.md opens the plan in Imark and the agent waits until you press Approve or Send Back, then reads your notes. That is a different job from opening every file an agent writes, which its plugin does not advertise.

Best for: anyone who wants the full reading feature set for free. Limits: the repository was created on August 5, 2026 and the current release is 0.6.6 (October 14), so expect fast change. Its README calls it "a personal project, maintained by one person", with "no support promise and no release schedule". Homebrew install goes through the developer's own tap. Requires: macOS 14.

Developer site: imarkmd.com

Markdown Preview (free): outline sidebar and Finder preview#

Markdown Preview is free and MIT-licensed, from pluk. Its README lists a Quick Look extension, Mermaid diagrams and math rendered offline, a document outline sidebar, a file navigator, an edit mode with a formatting toolbar, and mdp, a command line tool that opens a file or a folder. It installs from the official Homebrew cask (brew install --cask markdown-preview) or as a notarized DMG.

Best for: readers who want a free app with an outline for long files. Limits: it needs macOS 15 Sequoia, and the project started in April 2026, so it is young and changes fast: version 0.0.68 shipped on October 18, 2026. Its GitHub repository had 2,549 stars on October 20.

Developer site: markdownpreview.app

Readdown (free): simple, free and read-only#

Readdown is a free reader, distributed as a direct download or through the developer's Homebrew tap (brew install --cask nataliarsand/tap/readdown). Version 1.19 (October 9, 2026) covers Quick Look, Mermaid, live refresh, find, zoom, PDF export, math rendering and, new in 1.19, a table of contents panel, on macOS 13 or later. Its code is published on GitHub under a custom licence, so it is source-available rather than open source.

Best for: occasional readers who want Finder preview at no cost. Limits: a System, Light or Dark appearance instead of selectable reading themes (a pull request for themes is open). Open GitHub issues include local images not displaying and multi-line HTML comments rendered instead of hidden. I compare the two apps in detail in MacMD Viewer vs Readdown.

Developer site: readdown.app

QuickMD (free): a minimal native reader#

QuickMD is free and MIT-licensed, and its site promises "No trials, no subscriptions, no paywalls". It renders Mermaid diagrams you can click to enlarge, GitHub-style alerts and math, and it reloads the document when your editor saves. Version 1.12.0 (October 5, 2026) adds Source Edit: the window switches to the raw Markdown at the line you are reading, so you can fix a typo without opening an editor. It runs on macOS 13 or later. It left the Mac App Store when its developer's Apple Developer Program membership expired on October 6, 2026, so it now installs from GitHub or the developer's Homebrew tap, and its site says new releases cannot be notarized until the membership is renewed.

Best for: a clean, minimal free reader. Limits: no Quick Look extension is advertised. Its GitHub issues show a responsive developer: a report that 10,000-line files froze the window for a couple of seconds was closed.

Developer site: qmd.app

Marked 3: best preview companion for writers#

Marked 3 describes itself on the App Store as a "Markdown Preview application (NOT AN EDITOR)". You keep writing in your own editor and Marked renders the file live, with proofreading tools, Mermaid, math, custom themes and export to PDF, HTML, RTF and more. Version 3.2.22 shipped on October 17, 2026.

Best for: writers who need proofing and export next to Vim, BBEdit or iA Writer. Price: $2.99 a month, or $69.99 once at the current introductory price. Limits: Finder preview is a separate app, Marked QL. Marked 2 is still sold at $13.99 on the App Store, with its last update in March 2025; how Marked 2, Marked 3 and Marked QL differ covers the upgrade path.

Developer site: markedapp.com

Telescopo: reader, editor and AI assistant in one#

Telescopo was previously called Smackdown: same App Store listing, new name. It renders Mermaid, ZenUML and math, refreshes open files that change on disk ("Live Monitoring"), exports PDF, and adds a private AI assistant and 200+ templates.

Best for: people who want reading and editing in one native app. Price: a 7-day trial of full access, then $49.99 once for lifetime access. Limits: it requires macOS 15 Sequoia and advertises no Quick Look extension. More in MacMD Viewer vs Telescopo.

Developer site: telescopo.app

MD-Viewer (free, ad-supported)#

MD-Viewer is a free Mac App Store reader that runs on macOS 10.13 or later, which makes it an option for older Macs. The 124.8 MB download is large for a reader. Several App Store reviews complain about a "Sponsored by WebSumo" footer on exported PDFs, and one says there is no way to disable it. More in MacMD Viewer vs MD-Viewer.

App Store: MD-Viewer

MarkView (free, also on Windows and Linux)#

MarkView is a free reader for macOS, Windows and Linux from an independent developer. Its site says it is "Built for normal humans, not developers." It is the pick if you send Markdown files to people on other platforms. Its site does not mention Quick Look or Mermaid.

Developer site: markview.io

Quick Look extensions: preview Markdown in Finder without an app#

If all you want is a formatted preview when you press Space in Finder, you do not need a reading app. A Quick Look extension is enough.

QLMarkdown (free)#

QLMarkdown is a free GPL-3.0 extension, still maintained: 1.5.7 shipped on October 2, 2026 and the Homebrew cask qlmarkdown is active. It renders Mermaid and math through optional extensions whose libraries download the first time you run the app, and it adds a command line converter and Shortcuts actions. MacMD Viewer vs QLMarkdown explains when the free extension is all you need.

Repository: github.com/sbarex/QLMarkdown

Marked QL ($9.99)#

Marked QL is the Quick Look half of Marked, sold on its own for $9.99 with a free trial from the developer's site. It renders Mermaid, and App Store reviewers like its headings sidebar. It needs macOS 13 or later, and its App Store listing says it works without Marked. More in MacMD Viewer vs Marked QL.

Developer site: markedapp.com/ql

Watch out: Markdown Quick Look extensions can conflict#

Keep one Markdown Quick Look extension installed at a time. When several apps claim .md files, the one macOS picks may not be the one you just installed, so Finder can keep showing raw text. Marked QL reviewers described exactly this in July 2026, and its developer now ships a separate app, QuickLookDoctor, to sort out which extension owns the file type. The same applies to MacMD Viewer, MDV, Imark, Markdown Preview and Readdown: if the Space bar preview stops rendering, look for a second extension first.

Editors people use as Markdown viewers#

Editors render Markdown well, but they are built for writing. They make sense as a viewer if you already use one.

Typora ($14.99)#

Typora hides Markdown syntax as you type, so the document looks formatted while you edit it. It costs $14.99 once for up to 3 devices, with a 15-day trial; its site states system requirements for Windows only, not a minimum macOS version. G2 reviewers praise the distraction-free writing and regret that it stopped being free. Details in MacMD Viewer vs Typora.

Developer site: typora.io

Obsidian (free, paid Sync)#

Obsidian is a notes app built on a vault of local Markdown files, with links between notes and a large plugin ecosystem. The app is free; Sync costs $4 a month and Publish $8 a month, both billed yearly. Reviewers on G2 and Capterra keep mentioning the learning curve, which is a lot to take on to read a file. See MacMD Viewer vs Obsidian.

Developer site: obsidian.md

VS Code (free)#

VS Code has a built-in Markdown preview, and it renders Mermaid since version 1.121 (May 2026). It costs nothing extra if you already work in it every day.

Developer site: code.visualstudio.com

MarkViewer (free)#

Despite the name, MarkViewer is a free WYSIWYG editor: its Homebrew cask describes it as a "Minimal markdown editor". It renders Mermaid, runs natively on Intel and Apple Silicon, supports macOS 10.15 or later, and shows a diff banner when the file changes on disk.

Developer site: markviewer.com

What about MacDown?#

I no longer recommend MacDown for new installs. Its last release, 0.7.3, dates from January 3, 2020, a native Apple Silicon build has been requested on GitHub since 2020, and Homebrew disabled the macdown cask on September 1, 2026.

What about Markoff and MarkText?#

Both show up in Google for "markdown viewer mac", so here is where they stand on October 20, 2026. I don't count them among the 16 apps above.

Markoff is the free previewer Reda Lemeden announced on the thoughtbot blog in 2016. Its last release, 1.0.0, dates from February 29, 2016, the last commit to its repository is from October 2020, and its Mac App Store listing no longer exists. A Markoff 2 for macOS 11 was never released as a download: the README asks you to build it in Xcode. I treat it as abandoned, like MacDown.

MarkText is a free, MIT-licensed WYSIWYG editor, not a viewer, and it is active again: 0.22.0 shipped on October 18, 2026. Its README says macOS 11 or later, with separate Apple Silicon and Intel downloads. Its Mac builds are unsigned, so the release notes tell you to clear the quarantine flag in Terminal after installing, and Homebrew disabled the mark-text cask on September 1, 2026 because it fails Gatekeeper. If you want an editor, Typora or Obsidian install with less friction.

What do users say about these Mac Markdown apps?#

Public ratings are thin for Markdown apps: most have fewer than 20 reviews, so read the complaints rather than the stars.

App	Platform	Score	Reviews	What comes up most
MacMD Viewer	Trustpilot	4.4/5	17	Praise for Quick Look and Mermaid; one Mac per licence
Marked 2	App Store (6 countries)	4.3/5	87	Responsive developer; crashes and weak Word export
Marked 3	App Store	4.7/5	9	Fast bug fixes
Marked QL	App Store	4.7/5	6	Quick Look conflicts with other apps
Telescopo	App Store	4.0/5	9	Good for AI docs; upgrade prompts, Mermaid missing from PDF
MD-Viewer	App Store	2.5/5	8	Ads in exported PDFs
Typora	G2	4.3/5	11	Smooth writing; no longer free
Obsidian	G2 · Capterra · Trustpilot	4.5 · 4.8 · 3.2 (out of 5)	12 · 47 · 17	Learning curve; Sync is paid

App Store scores are the average of written reviews in the US, UK, Canada, Australia, Germany and France. QuickMD had a single App Store review before it left the store, too few to score.

A few complaints are worth reading before you choose:

• MacMD Viewer, Trustpilot, September 1, 2026: "it's annoying (and feels needlessly greedy) that my license only works for 1 Mac."
• MacMD Viewer, Trustpilot, July 30, 2026: "free plugins on VScode or Obsidian can do the same (Obsidian actually does it without plugins)."
• MD-Viewer, App Store, September 8, 2026: "the app adds ads to my exported PDFs and there is no way to disable it."
• Telescopo, App Store, February 3, 2026: when exporting to PDF, "the mermaid images are not available."
• Marked 3, App Store, June 30, 2026: "Would be better if it didn't crash so often."

Both MacMD complaints are fair. If you work on two Macs, the licence cost doubles, and if you already live in VS Code or Obsidian, their preview may be enough.

How I checked these 16 apps#

I chose the 15 apps from Google's results and AI Overview for "best markdown viewer for mac", "markdown viewer mac" and "md viewer mac" on September 15, 2026, plus long-standing names readers ask about. Markdown Preview joined on October 5, when Google's AI Overview for "markdown viewer macos" started naming it. On October 20, 2026 I re-read every price, version and minimum macOS from its source, and added the Markoff and MarkText notes because Google now ranks both for "markdown viewer mac":

• Mac App Store data through Apple's public lookup API and review feeds.
• Open-source releases and issues through the GitHub API.
• Homebrew cask status through the Homebrew formulae API.
• Features from each developer's own site or README, quoted where it matters. Readdown's feature list comes from its release notes, read up to 1.19 on October 20, 2026.
• Ratings from the App Store, G2, Capterra and Trustpilot, with review counts, last read on September 15, 2026; I did not re-read them for the October 20 update.

This is a research comparison, not a lab benchmark: I did not time app launches or install the competing apps for this comparison, so there are no speed or memory claims here. No app paid to be listed and there are no affiliate links. I build MacMD Viewer, and I will re-check this page in December 2026.

Frequently Asked Questions#

What is the best free Markdown viewer for Mac?

Imark is the strongest free pick in October 2026: it previews .md files in Finder with the Space bar, renders Mermaid diagrams and reloads when the file changes. It is open source (MIT) but very young, at version 0.6.6, and its optional agent plugin lets you review a plan before Claude Code or Codex continues. Markdown Preview, Readdown and QuickMD are solid free readers too. MDV offers the same three features as a direct download, with no price listed on its site.

How do I open a Markdown file on Mac?

Double-click opens a .md file in whatever app macOS has assigned to that file type, and pressing Space in Finder shows the raw text. To see it formatted, install a Markdown reader and set it as the default app for .md files, or install a Quick Look extension so the Space bar preview renders headings, tables and code.

Does macOS render Markdown on its own?

No. Finder's Quick Look preview and TextEdit show a .md file as plain text, so you see the # and * symbols instead of formatting. Rendering needs a third-party app or a Quick Look extension.

Which Mac Markdown viewers preview in Finder with the Space bar?

Among the apps in this comparison, MacMD Viewer, MDV, Imark, Markdown Preview and Readdown ship a Quick Look extension alongside a reading window, while QLMarkdown and Marked QL are Quick Look extensions only. Keep one Markdown extension installed at a time: when several claim .md files, the preview can keep showing raw text.

Should I use a Markdown viewer or a Markdown editor?

Use a viewer if you mostly read files that something else wrote, such as READMEs, specs or AI agent plans: it opens the file formatted and cannot change it by accident. Use an editor like Typora or Obsidian if you write Markdown more than you read it.

Which Markdown viewers render Mermaid diagrams on Mac?

MacMD Viewer, MDV, Imark, Markdown Preview, Readdown, QuickMD, Marked 3 and Telescopo render Mermaid in their reading window. QLMarkdown and Marked QL render it in the Finder preview. Typora, Obsidian and MarkViewer render it while editing, and VS Code renders it in its built-in preview since version 1.121 (May 2026).