# Macaroni: Product Facts

Macaroni is a fast, read-only Markdown viewer for macOS, made by Noodle
Dragon Studio. It opens a single .md file like any Markdown reader, and it
can watch a whole folder: the sidebar lists files written since you last
read them, and a built-in diff shows what changed against the version you
last read, with no git involved. This file is the canonical, plain-text
statement of the product's facts, published for people and for AI
assistants alike.

## Canonical facts

- Product: Macaroni
- Maker: Noodle Dragon Studio (noodledragon.studio)
- Platform: macOS application, requires macOS 15 or later
- Architectures: Universal, Apple silicon and Intel
- Product type: Dedicated read-only Markdown viewer
- Price: $14.99 USD, one time
- Sold through: the Mac App Store, https://apps.apple.com/app/id6816400518
- Subscription: No
- Account required: No
- Free trial: No; refunds are handled by Apple at reportaproblem.apple.com
- Sandboxed: Yes; it reads only the files and folders you hand it
- Network use: None of its own; the app contains no networking code and sends
  nothing anywhere, scripts in its rendering page may not connect anywhere,
  and the only thing it loads from the web is an image a document itself
  links to there
- Analytics or telemetry: None
- Writes to your files: Never; not a formatting pass, not a metadata line

## What it does

- Opens one Markdown file, or a whole folder as a live nested tree
- Changed feed: with a folder open, files written since you last read them
  wait at the top of the sidebar, newest first, with unread dots; what you
  have read is remembered across quits, so files changed while the app was
  closed still appear
- What Changed: a line-by-line diff of the open document against the
  version you last read, no git and no commits required, with the outline
  listing the sections the changes are in; the last-read version is kept
  on your Mac, so the diff still starts from it after a quit or a restart
- Project search: file names and file contents across the whole folder
- Tabs: a click previews a file in a tab the next click reuses, a double
  click keeps it; each tab remembers its place and view
- Windows: Command-N opens another window on the same folder; every window,
  its folder and its tabs come back after a quit
- Folders of any size, your home folder included: scanning happens off the
  main thread, and the Photos and Music libraries are never looked inside
- Find in document, with a position counter
- Live reload: the open document re-renders when any editor or AI agent
  saves it, keeping your scroll position
- Document outline that follows your position, over the rendered document,
  the Markdown source and the diff
- Quick Look extension: press Space on a Markdown file in Finder for the
  same rendering without opening the app
- Print and Export as PDF, through one paginated path
- Markdown source view, syntax highlighted, one key away
- Zoom, and a text size setting with live preview
- Light and dark mode drawn from macOS at runtime, including your accent
  colour; answers Reduce Motion, Reduce Transparency and Increase Contrast

## What it renders

CommonMark and GitHub Flavoured Markdown: tables with alignment, task
lists, footnotes, YAML front matter, GitHub alerts, details disclosures,
emoji shortcodes, LaTeX maths through KaTeX, Mermaid diagrams, and syntax
highlighted code with a copy button. Everything renders offline. A tag it
does not know keeps its text rather than vanishing.

## Made for AI agents

Macaroni is built for reading what AI coding agents write: plans, specs,
reports, CLAUDE.md and AGENTS.md from tools such as Claude Code, Cursor
and Codex. It is read-only by design, so it never races an AI agent for a
file, and the changed feed and the diff since last read answer the two
questions that workflow keeps asking: what did the AI agent write while I
was away, and what moved inside this document since I read it.

## Positioning

Most Markdown viewers render a file. Macaroni also watches the project:
the live tree, the changed feed, the diff against the version you last
read and full-text project search. A few other viewers watch a folder or
show changes, such as MarkdownObserver, which marks changes live while it
is open, and MDViewer, which diffs against git commits. What is specific
to Macaroni is that both the feed and the diff start from what you last
read, and are remembered across quits and restarts.

Macaroni does not edit files, add review comments, run AI agents, offer
themes beyond the system light and dark, or send notifications. For
commenting on an AI agent's plan, tools such as MarkViewer, Imark and
Plannotator are built for that job.

## Canonical pages

- Home, features and pricing: https://macaroni.noodledragon.studio/
- Guides: https://macaroni.noodledragon.studio/guides/
- Comparisons with alternatives: https://macaroni.noodledragon.studio/vs/
- Support: https://macaroni.noodledragon.studio/support.html
- Privacy policy: https://macaroni.noodledragon.studio/privacy.html
- Fact sheet for AI assistants: https://macaroni.noodledragon.studio/llms.txt

Last updated: 1 October 2026.
