Macaroni $14.99 · one time

Compare

Macaroni vs MarkdownObserver: two ways to watch a folder

MarkdownObserver is the app in the field closest to Macaroni: it also watches a folder of Markdown and shows you what changed. It is cheaper, it is open source, and it does several things Macaroni does not. The real difference is memory: what each app compares against, and what is still there after you quit.

Published 28 September 2026 · MarkdownObserver facts read from its App Store page, its website and its public source code on 28 September 2026

Credit first. MarkdownObserver, by Lars Pohlmann, costs $3.99 on the Mac App Store, is MIT licensed on GitHub, and collects no data. Point it at a folder, subfolders included, and new Markdown files open themselves as they appear. Each document carries live change markers in the margin, green for additions and orange for edits, and you can step through the changes or compare before and after side by side. It renders Mermaid, KaTeX maths, footnotes and callouts, offers more than a dozen reader themes from Paper and Tufte to Nord and Tokyo Night, can post a notification when a watched file changes, and has a split view for editing the source. For $3.99 that is a lot of app.

Side by side

 MacaroniMarkdownObserver
Price$14.99 one time, Mac App Store$3.99, Mac App Store; open source (MIT)
The diff compares againstThe version you last read, however long ago that wasA version from a set time ago, 10 seconds to 10 minutes, or one you pick from the versions it saw while open
After you quitKept: last-read copies are saved on your Mac, so the next diff still starts from your last readingGone: version history is held in memory, up to 32 versions a file, and starts again at launch
Changes made while the app was closedWait in the changed feed at the next launchNot tracked: it marks the changes it sees happen
Folder viewThe whole folder as a live nested tree, with the changed feed above itA sidebar of the documents it has opened, grouped by subfolder
New filesAppear in the tree and the feed, and wait for youOpen automatically as they appear
Search across the folderYes, file names and contentsNo; not on its site, its store page or in its source
NotificationsNoYes, optional
ThemesOne look that follows macOS light and dark and your accent colourMore than a dozen reader themes
EditingNever; read-only by designYes: a split source view that saves to the file
Mermaid, maths, footnotesYes, plus GitHub alerts, front matter and disclosuresYes, plus callouts
Quick LookYes, press Space in FinderNo extension
Minimum macOS1515

Watching a change happen, or catching up on it

MarkdownObserver is built for watching. An AI agent saves, the file opens, the markers show what moved in the last minute or two. If you sit beside the agent and follow its work as it lands, that is exactly the right model, and its automatic opening and notifications make it better at following along than Macaroni is.

Macaroni is built for coming back. You read the plan at ten. The agent rewrote it three times over lunch, and you quit the app, or restarted the Mac, in between. At two, the changed feed lists the plan with an unread dot, and ⇧⌘D shows everything that moved since ten, in one comparison. A diff measured from "ten minutes ago" or from "since the app launched" cannot answer that question, because the version you read is older than both.

Macaroni's What Changed on a Mac: a line by line Markdown diff against the version last read, with the outline naming the changed sections.
Macaroni's What Changed: measured from your last reading, even across a quit or a restart.

The other divide: it can edit, Macaroni cannot

MarkdownObserver's split view lets you fix a line in the source and save it. Macaroni has no way to write to a Markdown file at all, which is the point when an AI agent owns the folder: there is no editor buffer to go stale over a fresh save, and nothing you do in the reading window can end up in the agent's files. If you want to edit where you read, MarkdownObserver is the better fit.

Choose MarkdownObserver 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