Free · open source · designed for Mac

A free Markdown viewer for Mac.

Open and preview .md files as clean documents. Add a comment to any phrase and the note stays inside the file — invisible everywhere else.

macOS 14+ · 5.8 MB

Markdown you can argue with.

The whole idea

Your notes travel with the file.

Select a phrase, write what you think, and it is saved into the document as an HTML comment. Send the file to someone, open it on another machine, commit it — the note is still there, and no other app shows it.

IN IMARK
The deadline is generous but achievable.

   Achievable with which team?
    This needs a number, not
    an adjective.
EVERYWHERE ELSE
The deadline is generous but achievable.

<!-- imark quote="generous but achievable"
by="miguel" at="2026-08-02T14:31Z"
Achievable with which team? -->
Reviewing an agent

Your agent writes.
You answer in the margin.

Imark ships a review skill for Claude Code and Codex. The agent opens its Markdown plan and waits; you comment on exact phrases, then approve or request changes. The notes stay in the file, with no review server or separate account.

1

Claude Code or Codex opens its plan in Imark and waits.

2

You read it as a document and mark it up.

3

Approve, or request changes.

4

It reads your notes back and carries on.

In the Finder

Space bar. No app to open first.

A Quick Look extension renders the file in place, with the same typography, code highlighting and diagrams as the app itself.

And the quiet parts

Everything you expected
it to already do.

Keep your editor where it is

Write in Cursor, VS Code, Zed, anything. Imark follows every save and keeps your scroll position, so you can leave it open on the other half of the screen and stop switching windows.

Never lose the thread

The outline folds itself on long documents and follows you as you scroll.

Diagrams and maths

Mermaid and KaTeX are bundled in. They work on a plane.

One window

Tabs, find, print to PDF with the comments included.

Nothing of yours leaves the machine

Documents render offline, every remote request blocked. The one network call — an optional daily check for new versions — carries a version number and nothing else.

Open source

Yours as much as mine.

MIT licensed, and the whole thing is about 5,000 lines of Swift you can read in an afternoon. Issues get answered. If it breaks one of your files I want to hear about it before anything else.

A star costs you nothing and makes my week

It is the only way I find out whether anyone is using this.

Star on GitHub
Markdown on Mac

Start with the job you need to do.

Open a file, preview it in Finder, read technical Markdown, or add a human review gate to Claude Code and Codex. Each guide gives you the direct path.

Questions

The ones people actually ask.

Select a markdown file in Finder, press ⌘I, choose Imark under “Open with”, and click “Change All…”. Imark registers as an alternate handler, so it never takes the association without being asked.

Free. Open source. Offline.