Macaroni $14.99 · one time

Compare

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.

Published 27 September 2026 · QLMarkdown facts checked against its GitHub repository on 27 September 2026

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

 MacaroniQLMarkdown
What it isA read-only reading app, plus a Quick Look extensionA Quick Look extension; its README says it is not a viewer
Price$14.99 one time, Mac App StoreFree, GPL-3.0
Quick Look on SpaceYesYes, and it is the whole product
A window that stays openYes: scroll, outline, search, second monitorNo, by design
Mermaid diagramsYes, offlineYes
LaTeX mathsYes, KaTeXYes, MathJax
Watches a folderYes: live tree, changed feed, unread dotsNo
Diff since last readYes, line by line, no gitNo
Project searchYes, names and contentsNo
Live reload while readingYes, keeping your scroll positionNo reading window to reload
File formatsNine Markdown extensions, .mdx, .qmd and .rmd includedThe same, plus Cursor .mdc rules, API Blueprint and textbundle packages
TelemetryNone; no networking code at allNone, per its README
Minimum macOS1511
SupportA developer whose income depends on answering, within two working daysGitHub issues, provided as is

Where QLMarkdown wins

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.

A Markdown document open in Macaroni's reading window on a Mac, with a table, an alert, a Mermaid diagram and a task list rendered, the part that begins where a Quick Look preview ends.
After the glance: the same rendering, in a window built for actually reading.

Choose QLMarkdown if

Choose Macaroni if

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