The Markdown viewer that reads the folder.
Open one file like any viewer, or point it at a project: Macaroni lists what changed since you last read it, even while it was closed, and shows you exactly what moved.
Made for reading what Claude Code, Cursor and Codex write.
Watch it work.
Forty-five seconds, with sound: an agent rewrites three documents, and Macaroni shows you what changed.
Built to stay open beside the terminal.
A reading window that cannot race your AI agent for a file, because it never writes one.
Read-only
Not a formatting pass, not a metadata line. Your files stay exactly as your agent left them.
Remembers
What you have read survives a quit and a restart, so changes made while it was closed are waiting.
Native
A real Mac app in the system's own materials and colours, light and dark, Apple silicon and Intel.
Private
No networking code, no account, no analytics. Nothing about you or your files is sent anywhere.
The changed feed
Come back to an inbox, not a folder.
Files written since you last read them wait at the top of the sidebar, newest first, with a dot beside anything you have not seen. The tree stays true as files appear, change and go, and reading a file is what clears its dot.
More about the changed feedEverything that moved since you last read it.
Not since the last commit: since you. No git, no saved copies. Your last reading is the baseline, kept across a quit, the comparison holds still while you read it, and the outline beside it lists the sections the changes are in.
More about What Changed
It renders what your documents actually contain.
GitHub Flavoured Markdown in full, offline, with every library it needs inside the app.
Mermaid diagrams
Flowcharts and sequence diagrams, drawn from text.
LaTeX maths
Inline and display formulas, through KaTeX.
GitHub alerts
Note, tip, important, warning and caution.
Tables, with their alignment
Left, centre and right, as the Markdown says.
Task lists
Ticked on screen, and ticked when printed.
Highlighted code
With its language named and a button to copy it.
Also footnotes, YAML front matter, <details> and emoji shortcodes. A tag it does not know keeps its text rather than vanishing.
Tabs and windows
Tabs that stay out of the way.
A click previews a file in an italic tab the next click reuses, so reading through a folder never buries you in tabs. A double click keeps it. ⌘N opens another window on the same folder, and every window comes back as you left it: its folder, its tabs in order, and where you were in each.
Press Space in Finder.
The Quick Look extension shows the same rendering, diagrams and maths included, without opening the app. And it is a plain Markdown viewer too: double-click a .md file and it opens on its own, no folder and no setup, re-rendering in place every time the file is saved.
Light and dark
Dark when your Mac is.
Text, surfaces, selection and your accent colour come from macOS as it runs, so switching to dark, back to light, or to a new accent takes effect live, without a restart. It answers Reduce Motion, Reduce Transparency and Increase Contrast, and printing is black on white whichever appearance you are in.
Small things, done properly.
Search the whole project
Files whose names match first, then the lines inside each file, with a count.
Markdown source, one key away
The file as written, highlighted, at the same measure.
An outline that follows you
Over the page, the source and the diff, folding away when the window is narrow.
Print, and Export as PDF
One paginated path, black on white in either appearance.
Select All means the document
The words on the page, and nothing around them.
A measure set by counting
Near 88 characters a line at the default size, with the size in your hands.
Once. No subscription, no account, no trial to forget.
- The watched folder, the changed feed and What Changed
- Tabs, windows, project search and the outline
- Mermaid, KaTeX, alerts, tables and highlighted code
- Quick Look in Finder, print, and Export as PDF
- Light and dark mode, following your Mac
- macOS 15 or later, Apple silicon and Intel
Purchases and refunds are handled by Apple. Questions first? Support answers within two working days.
Questions, answered.
What is Macaroni?
Macaroni is a read-only Markdown viewer for the Mac, made by Noodle Dragon Studio. It renders a single .md file like any viewer, and it can watch a whole folder: the sidebar lists the files written since you last read them, and What Changed shows exactly what moved in each one, with no git involved. It is made for reading what AI agents such as Claude Code, Cursor and Codex write.
How much does Macaroni cost?
$14.99, once, on the Mac App Store. There is no subscription, no account and no in-app purchase, and every feature is included.
Do I have to open a folder? Can it just view one Markdown file?
It works exactly the way you expect a Markdown viewer to work: double-click a .md file in Finder, drop it on the window, or press Space for a Quick Look preview, and the rendered document is what you get. The folder, the changed feed and the diff are the layer on top, there when a whole project needs reading and invisible when it does not.
Does it work with Claude Code, Cursor and other AI agents?
That is what it is for. Watch the project folder while an AI agent works: new and rewritten documents surface in the changed feed, the open document re-renders as it is written, and the diff shows what moved since you last looked. Macaroni does not care which tool did the writing.
Can it edit my files?
No, by design. It never writes to a Markdown file: not a formatting pass, not a metadata line. Reading is the whole app, and the read-only promise is what makes it safe to point at a folder an AI agent is working in.
What does it render?
CommonMark and GitHub Flavoured Markdown: tables, task lists, footnotes, YAML front matter, GitHub alerts, disclosures, emoji shortcodes, LaTeX maths through KaTeX, Mermaid diagrams and syntax highlighted code. A tag it does not know keeps its text rather than vanishing.
Does it need the internet?
No. Everything it needs ships inside the app, Mermaid and KaTeX included, and it has no networking code of its own: no account, no analytics, nothing about you or your files sent anywhere. The only thing it ever loads from the web is an image a document itself links to there, fetched the way a browser would, and scripts in the page are not allowed to connect anywhere. The privacy policy is one page because there is nothing to describe.
How do I preview Markdown in Finder?
Macaroni includes a Quick Look extension: select any Markdown file in Finder and press Space, and the same rendering appears without opening the app.
Is there a free trial?
The Mac App Store does not offer trials for one-time purchases, and Macaroni will not adopt in-app purchase machinery just to fake one. If it turns out not to fit, Apple handles refunds at reportaproblem.apple.com.
Which Macs does it run on?
macOS 15 or later, on Apple silicon and Intel.