Macaroni vs QLMarkdown: a reader, or a glance
QLMarkdown is free, open source, actively maintained, and by its own README it is not a Markdown viewer: it is a Quick Look extension. We make Macaroni, which is a viewer, so the honest comparison is about where a glance stops being enough.
First, the facts as they stand today, from the source. QLMarkdown is
GPL-3.0, not archived, and visibly alive: version 1.5.5 was released
on 23 September 2026, four days before this page was written, and the
repository holds about 3,600 stars. It renders Mermaid, LaTeX maths
through MathJax, and a long list of formats including
.qmd, .rmd and .mdx, on macOS
11 and later. If a free rendered preview on Space in Finder is
everything you want, install QLMarkdown and stop reading: it does that
job well, and this page just saved you $14.99.
The comparison is really two sentences
QLMarkdown's README states, in bold, that it is not intended to be used as a Markdown viewer; its window exists to configure the preview. That is not a criticism, it is the author's own scoping, and it is what makes the products hard to confuse: QLMarkdown is an extension without an app around it, and Macaroni is an app that also ships the extension. A Quick Look panel is modal, it closes on your next click, and it is built for the two-second question. A reading window stays open, holds your place, and answers the questions that come after the glance.
Side by side
| Macaroni | QLMarkdown | |
|---|---|---|
| What it is | A read-only reading app, plus a Quick Look extension | A Quick Look extension; its README says it is not a viewer |
| Price | $14.99 one time, Mac App Store | Free, GPL-3.0 |
| Quick Look on Space | Yes | Yes, and it is the whole product |
| A window that stays open | Yes: scroll, outline, search, second monitor | No, by design |
| Mermaid diagrams | Yes, offline | Yes |
| LaTeX maths | Yes, KaTeX | Yes, MathJax |
| Watches a folder | Yes: live tree, changed feed, unread dots | No |
| Diff since last read | Yes, line by line, no git | No |
| Project search | Yes, names and contents | No |
| Live reload while reading | Yes, keeping your scroll position | No reading window to reload |
| File formats | Nine Markdown extensions, .mdx, .qmd and .rmd included | The same, plus Cursor .mdc rules, API Blueprint and textbundle packages |
| Telemetry | None; no networking code at all | None, per its README |
| Minimum macOS | 15 | 11 |
| Support | A developer whose income depends on answering, within two working days | GitHub issues, provided as is |
Where QLMarkdown wins
- It is free, well made, signed, notarised, and released as recently as this week. For previews alone there is no reason to pay anybody.
- Older Macs. It runs back to macOS 11; Macaroni needs 15.
- More formats. Both preview
.mdx,.qmdand.rmd, but QLMarkdown also covers Cursor's.mdcrules files, API Blueprint and textbundle packages, and recognises the file types RStudio and Quarto register when they are installed. - It can coexist with anything, including Macaroni: macOS lets you choose which Quick Look extension handles a file type in System Settings.
Where Macaroni is a different product
Everything Macaroni adds happens after the glance. The document opens in a window that stays open, with an outline that follows you, search in the document and across the project, and a text size you choose. Leave it pointed at a folder while an AI agent writes into it and the sidebar becomes a changed feed of what you have not read yet; the open document re-renders as it is saved without losing your place; and ⇧⌘D shows what moved since you last read the file, line by line. A Quick Look panel can do none of that, not because QLMarkdown is limited but because Quick Look is a glance by construction.
Choose QLMarkdown if
- A rendered preview on Space is all you want.
- Your Mac runs macOS 11 to 14.
- You preview
.mdc, API Blueprint or textbundle files.
Choose Macaroni if
- The glance keeps turning into a read: long plans, specs and reports rather than two-line notes.
- You read whole folders and want to know what changed since you last looked, as a feed and as a diff.
- You want one app to be both the preview in Finder and the reading window it opens into.
Macaroni is a fast, read-only Markdown viewer for macOS with a Quick Look extension included: the same rendering on Space and in a window built for reading, plus a watched folder, a changed feed and a diff since you last read. $14.99, one time, no subscription.
See what it does