Macaroni $14.99 · one time

Compare

Macaroni vs mdown: what does the $14.99 actually buy?

mdown is the best free Markdown viewer on the Mac, and this page says so before it says anything else. We make Macaroni, the paid one, so the burden of proof runs our way: if free does your job, install mdown and keep the money.

Published 27 September 2026 · mdown examined hands-on, feature by feature, on 20 September 2026, version 1.0.17

This comparison is unusually grounded: we installed mdown and drove every feature it has, then put one technical document through both apps and recorded what each rendered. The dates matter, mdown ships often, so treat everything below as a snapshot of version 1.0.17.

Side by side

 Macaronimdown
Price$14.99 one time, Mac App StoreFree, at mdown.app
Read onlyYes, by designYes
Quick Look extensionYesYes
Live reloadYes, keeping your scroll positionYes
Mermaid diagramsRenderedShown as literal markup
LaTeX mathsRendered, KaTeXShown as literal markup
GitHub alerts, footnotes, front matter, disclosures, emoji shortcodes, table alignmentAll renderedAll shown as literal markup, checked with one file through both apps
Folder viewA real nested tree that stays liveOne flat alphabetical list per folder
Project searchFile names and file contentsFile name filter only
Changed feedYes, with unread dotsNo
Diff since last readYes, line by line, no gitNo
Tabs and windowsDocument tabs with previews, and a window per folderDocument tabs and multiple windows
Windows versionNoYes
SandboxedYes, Mac App Store rulesNo; notarised Developer ID with Sparkle auto-update
Minimum macOS1514

What mdown does well, genuinely

mdown is native SwiftUI, small, fast, and free without a catch. It has document tabs, preferences with a live preview, zoom, a copy button on code blocks, and a button that makes it the default app for .md files. Its interface writing is excellent: every empty state explains itself and offers the next action. It runs on macOS 14 where Macaroni needs 15, and it has a Windows build if your life spans both platforms. If what you read is READMEs and plain notes, mdown is the correct answer and it costs nothing.

Where the free answer stops

Rendering, checked with one file

We put a single document containing a Mermaid diagram, a formula, footnotes, a GitHub alert, YAML front matter, a <details> disclosure, emoji shortcodes and an aligned table through both apps. In Macaroni all of it renders. In mdown 1.0.17 every one of those constructs appears as literal markup: the raw ```mermaid fence, the raw $$, the raw > [!NOTE]. That matters more than it used to, because documents written by AI agents lean on exactly these constructs: plans arrive with diagrams, alerts and task lists, and a viewer that shows them as source sends you back to the terminal.

Macaroni rendering the constructs mdown shows as literal markup: a table with alignment, a GitHub alert, a Mermaid diagram, a KaTeX formula and a task list.
The one-file test, rendered in Macaroni: the diagram, the alert, the formula and the aligned table.

The folder

mdown lists a folder as one flat, alphabetical list of file names. In a real project that breaks down fast: a repository with fifteen files called SKILL.md becomes fifteen identical rows with nothing to tell them apart, and the filter searches names only. Macaroni keeps the real nested tree, live as files appear and go, and searches contents as well as names.

What changed

Neither the changed feed nor the diff exists in mdown in any form, and this is the actual reason Macaroni costs money in a field with good free apps. Come back after two hours away and Macaroni lists which documents were written since you last read them; ⇧⌘D then shows what moved inside one, line by line, against the version you read. If nothing in your week needs that, be honest with yourself and use mdown.

Choose mdown if

Choose Macaroni if

Macaroni is a fast, read-only Markdown viewer for macOS: open one file like any viewer, or watch a whole folder and see what changed since you last read it. Mermaid, KaTeX, Quick Look, live reload. $14.99, one time, no subscription.

See what it does