Markdown Viewer for AI Agents MD Viewer for macOS
A fast, native Markdown viewer for macOS. Open the plan, report or checklist your coding agent is working on, and the page updates the moment the file changes.
€2.99 once. No subscription, no in-app purchases.
Get it on the Mac App StoreRequires macOS 14 Sonoma or later. Runs natively on Apple silicon and Intel.
Move app settings from UserDefaults to a SQLite store without losing anyone’s preferences.
All suites pass on macOS 14 and 15.
Coding agents leave Markdown everywhere: plans, progress reports, checklists, READMEs, docs. MD Viewer is a viewer, not an editor, so it opens instantly and stays out of the way while the agent works.
Most agents and editors save by writing a temporary file and renaming it over the original. MD Viewer catches those atomic saves too, so what you see is never stale.
Your scroll position stays where it was. Scroll to the bottom and MD Viewer follows new content as it arrives, like tail -f.
# how an agent saves plan.md write plan.md.tmp rename plan.md.tmp → plan.md # MD Viewer reloads here; your place is kept
GitHub Flavored Markdown with tables, task lists, strikethrough and autolinked URLs, plus GitHub-style alerts: NOTE, TIP, IMPORTANT, WARNING and CAUTION.
Code blocks get syntax highlighting for many languages and a one-click Copy button.
Note
The migration is idempotent and safe to run twice.
Warning
Two tests were flaky on Intel; rerun before merging.
| Suite | Passed | Failed |
|---|---|---|
| Unit | 214 | 0 |
| Migration | 18 | |
| UI | 37 | 0 |
Flowcharts, sequence diagrams, Gantt charts and more render in place and follow your appearance setting. If a diagram has a mistake, you see a readable error instead of a blank space.
Diagrams and syntax highlighting are built in and work offline.
MD Viewermermaid code block, as MD Viewer draws it.Click a checkbox and MD Viewer saves the change back to the file, so you can tick off an agent’s plan as you review it. Prefer documents to stay read-only? Turn it off in Settings.
YAML front matter, common in agent skill and plan files, appears as a collapsible panel instead of a block of raw text.
Try them. Here the boxes only toggle; in MD Viewer each click is saved to the file.
The sidebar lists every heading and highlights the section you’re reading. Word count and reading time sit underneath.
Search the document with ⌘F and ⌘G, change the text size with ⌘+ and ⌘−, and pick light, dark or the system appearance.
2,310 words · 10 min read
When something needs changing, ⇧⌘E opens the file in your editor. Choose it once in Settings.
Images work too. Pictures from the web load as they would in a browser, and local images appear once you give MD Viewer access to their folder, a one-time step explained in Support.
plan.mdIt drafts a plan, a report or a checklist into your project folder.
Open the file once. Every time the agent saves, the view updates in place.
Tick items as you review. Each change is saved to the file, where the agent can read it.
MD Viewer works with anything that writes Markdown files, including Claude Code, Codex, Cursor, GitHub Copilot and Gemini CLI. It has no AI features of its own. It’s where you read what your tools write.
MD Viewer runs in the macOS App Sandbox. It reads only the files you open and the folders you choose to share with it.