A familiar Mac reader.
A clearer document.
Real pages, numbered thumbnails, zoom, and a two-page view. Or switch to continuous scrolling. The Markdown underneath stays the same.
Made for your Mac. Built around your words.
Your Markdown.
A clearer point of view.
Read beautifully. Keep your notes close.
See exactly what changed while you were away.
Free & open source · v0.5.3 · macOS 14+ · Apple silicon & Intel
Not yet notarized. First-launch instructions · Change tracking needs the CLI.
The real thing, not a mock-up: this runs the Mac app's own preview code (v0.5.3) in your browser with a sample plan. Take over any time; nothing leaves your browser.
A small change. A clear picture.
The plan moved on.
You don’t have to start over.
Instead of reading the whole document again, see exactly what changed and who reported each change. This is the app’s real review view, after two agents edited a plan: step through the changes, restore the removed question, compare versions in History, then mark it as read.
A more thoughtful place for Markdown
Read it like a document.
Keep control like an editor.
A familiar Mac reader.
Your thoughts stay
with the passage.
Highlight in five colors. Add a note and tuck it away. When the text changes, annotations follow it, or wait for you to reattach them if the match is uncertain.
Change a sentence.
Leave the rest alone.
Read, Edit, and Split modes. No surprise reformatting or autosave over your file. Unchanged saves preserve the original bytes.
Source when you need it
Two views.
One ordinary file.
Edit your Markdown on the left. Check the result on the right. Your documents remain files you can open with other tools, without importing them into a private library.
Explore the app guide ↗A live example, not a screenshot
Try both sides of the page.
# SourceEdit a heading.
Change a sentence.
Add a list item.
Change a sentence.
Add a list item.
Preview ↗See the same words
rendered as
a readable document.
rendered as
a readable document.
The example stays in your browser. It does not access your files.
The same story, for your agents
Less rereading.
More getting on with it.
Each agent has its own “last looked” point. The CLI and MCP server return the changed blocks, with old and new text and reported authorship.
A planner, an implementer, and you can share one history without making a Git commit for every edit.
Set up the companion CLI ↘mdeditdiff / implementerLOCAL HISTORY
$ mdeditdiff changes plan.md --reader implementer 3 changes since r1, your last look. Reported by planner: “Added streaming and a row limit” ~ Implementation Build the CSV on the server{+, streaming rows+}. − Open questions Should exports include archived rows? + Decision Limit exports to 100,000 rows. Unchanged sections omitted.
Get back to the document
A Mac app for you.
A small companion for your agents.
Start with the app for reading, editing, pages, and notes. Install the companion CLI too for shared history, change review, and restore.
Download the Mac app
Unzip the download and drag mdEditDiff into Applications. Works on macOS 14 or later, on Apple silicon and Intel.
Download v0.5.3 ↓Add shared history
Requires Node.js 20 or later. Run this once in Terminal to install the CLI and MCP server.
npm install -g https://github.com/roy-vinay/mdeditdiff/releases/download/v0.5.3/mdeditdiff-cli.tgzConnect your agent
For Claude Code, run the command below. Other MCP clients can use the configuration in the guide.
claude mcp add mdeditdiff -- mdeditdiff mcpBefore your first launch: this release is not notarized by Apple. If macOS blocks it, click Done, then open System Settings → Privacy & Security → Open Anyway and confirm. Review the release notes and checksums before installing.
A clear picture of today
Useful now.
Room to grow.
mdEditDiff is actively developed. Here’s what’s in the current release, and what’s still ahead.
In v0.5.3
- Read, Edit & Split modes AVAILABLE
- Pages, thumbnails & two-page view AVAILABLE
- Highlights & text-anchored notes AVAILABLE
- Change review, history & restore WITH CLI
- CLI & six MCP tools AVAILABLE
- Local storage, no account or telemetry BY DESIGN
On the roadmap
- Signed and notarized Mac download PLANNED
- Settings window & Open Recent PLANNED
- Annotation import & export PLANNED
- Folder overview of unread changes PLANNED
- Expanded Preview-inspired tools PLANNED
No promised release dates. Share a feature request ↗
A few good questions
Before you open a file.
Does my document leave my Mac?
The app, history, and personal annotations are stored locally. No account or telemetry is required. Documents do not need to be uploaded, and the preview does not automatically load remote images.
Do I need the command-line tool?
For reading, editing, pages, highlights, and notes, no. For change tracking, shared revision history, and restore in the Mac app, install the companion CLI. It also gives your agents access through commands or MCP.
Is this another AI writing app?
No. mdEditDiff helps you read and review what people and agents write. It does not generate your text or require an AI subscription. Agent connections use the CLI or MCP.
Does it replace Git?
No. Git remains your repository history. mdEditDiff keeps a separate local history and a last-look point for each reader, so you can inspect changes between commits. Authorship is self-reported, not verified.
Can I use my files in another editor?
Yes. They remain ordinary UTF-8 Markdown files. Notes and highlights live separately in the app’s local storage, so copying a Markdown file alone does not carry those annotations. The history currently follows file paths; renaming a file starts a new history.
Is it free, and can I contribute?
Yes. The project is open source under the MIT license. Read the source, report an issue, or suggest a workflow that would make it more useful.
A better home for
your next Markdown file.
A little less catching up. A little more moving forward.