# DotMD

> DotMD is a Mac app for the Markdown your AI agents write. Read any .md file rendered,
> comment on the exact passage, and let Claude Code, Codex, Cursor or any MCP client fix it:
> every change shows up in the file for you to accept, like a pull request for documents.
> It is also a native Markdown reader and editor. Everything stays on your Mac.

- Review: comments tied to passages and lines; fixes shown in the file (old text in red, new in green); Accept, Reopen, Accept All.
- Agents over MCP: DotMD runs a local MCP server (http://127.0.0.1:8089/mcp); agents open files, read your comments, fix them and send drafts for review (request_review).
- Reading: tables, code with highlighting, Mermaid diagrams, KaTeX formulas, callouts, footnotes, front matter; Quick Look in Finder.
- Editing and history: live preview; every change saved to the file; a version kept whenever anyone changes the file; compare, revert one block, restore.

## Key facts
- Platform: macOS 14 or later (see Links for where to get it).
- Site languages (12): English, Czech, German, Spanish, French, Italian, Japanese, Polish, Portuguese (Portugal), Russian, Ukrainian, Traditional Chinese (English at the addresses below; each other language under its prefix: /cs/, /de/, /es/, /fr/, /it/, /ja/, /pl/, /pt/, /ru/, /uk/, /zh-hant/, as in https://getdotmd.com/de/guides).
- No account. Files, comments and history stay on the Mac. The MCP server listens on localhost only.
- Reading is free. DotMD Editor adds editing, search across files, export and version history; DotMD Reviewer adds comments and reviews, agents over MCP, highlighted history and AI actions.
- Trial: the version downloaded from getdotmd.com includes a free 3-day trial of all features (DotMD Reviewer), once per Mac, with no account and no payment needed. The Mac App Store version has no trial for now.
- Made by a solo developer.

## Best uses
- Reviewing specs, plans and design docs written by Claude Code, Codex or Cursor.
- One agent reviewing another agent's draft, with you moderating the comments.
- Reading READMEs and docs folders rendered; editing Markdown with a live preview.

## Connect an agent
- Claude Code: `claude mcp add -s user --transport http dotmd http://127.0.0.1:8089/mcp`
- Codex: `[mcp_servers.dotmd]` with `url = "http://127.0.0.1:8089/mcp"` and `tool_timeout_sec = 3600` in ~/.codex/config.toml (tool_timeout_sec lets Codex wait while you review).
- Cursor, Visual Studio Code and other MCP clients: `{"mcpServers":{"dotmd":{"type":"http","url":"http://127.0.0.1:8089/mcp"}}}`
- An agent in a Docker container: use http://host.docker.internal:8089/mcp instead of 127.0.0.1.
- The ChatGPT app can't connect (it reaches MCP servers from the internet, DotMD answers only on the Mac); use Codex for OpenAI's models.
- DotMD must be open while the agent works (Settings → MCP → Start with DotMD).

## Privacy
- No accounts. Your files, comments, versions and settings stay on your Mac; we can't see them.
- A DotMD purchase is recorded under a random ID, without your name. Apple or Paddle take the payment under their own policies.
- AI actions send text only to the provider you set up with your own key (or run on the Mac with Apple Intelligence), never to us.
- Anonymous usage statistics (which features are used, never your files or text) can be turned off in Settings. No advertising, no selling of data.
Full policy: https://getdotmd.com/privacy

## Pricing

- Free: reading Markdown files, forever.
- DotMD Editor $14.99 once, DotMD Reviewer $39.99 once; Editor owners upgrade to Reviewer for $24.99.
- Editor: editing with live preview, search across files, export, print, copy, version history (browse and restore). Reviewer adds reviews with agents, comments, agents over MCP, highlighted history and AI actions.
- US prices as of 2026-11-08; prices vary by country.

## Links

- Site: https://getdotmd.com/
- Availability: direct download (DMG)
- Mac App Store: coming soon
- Direct download (DMG): https://downloads.getdotmd.com/DotMD-1.0.19-35.dmg
- Support: support@getdotmd.com
- FAQ: https://getdotmd.com/#faq

## Pages
- [Home](https://getdotmd.com/): what DotMD does, the review loop with agents, the reader and editor, pricing and FAQ.
- [Guides](https://getdotmd.com/guides): step-by-step guides to connecting agents, reviewing and reading.
  - [Claude Code](https://getdotmd.com/guides/claude-code): connect Claude Code with one command and review its plans and specs.
  - [Codex](https://getdotmd.com/guides/codex): add DotMD to Codex (app, CLI, IDE extension), tool_timeout_sec, AGENTS.md.
  - [Cursor](https://getdotmd.com/guides/cursor): add DotMD to Cursor, Visual Studio Code or any MCP client.
  - [MCP server](https://getdotmd.com/guides/mcp-server): turn the server on, the tools an agent can call, Recent Requests, security, Docker.
  - [CLAUDE.md and AGENTS.md](https://getdotmd.com/guides/claude-md-agents-md): read and edit your agent's instruction files, and add DotMD's review rules to them in one click.
  - [Claude Code plan mode](https://getdotmd.com/guides/claude-code-plan-mode): where Claude Code saves its plans (~/.claude/plans, plansDirectory), and how to read, comment on and approve them.
  - [Codex plan mode](https://getdotmd.com/guides/codex-plan-mode): Codex's /plan proposes a plan in the chat; ask for it as a file, review it, let Codex fix your comments.
  - [Cursor plan mode](https://getdotmd.com/guides/cursor-plan-mode): Cursor's Plan Mode, Save to workspace, and reviewing the plan with comments.
  - [Spec-driven development](https://getdotmd.com/guides/spec-driven-development): spec, plan, tasks, build with Claude Code, Codex and Cursor, and where human review fits.
  - [GitHub Spec Kit](https://getdotmd.com/guides/github-spec-kit): review the spec.md, plan.md and tasks.md Spec Kit has your agent write.
  - [Comments](https://getdotmd.com/guides/comment-on-markdown): comment on a passage of a Markdown file; the Review panel.
  - [Reviewing changes](https://getdotmd.com/guides/review-ai-changes): check an agent's fixes in the file, accept or reopen, version history.
  - [Reading Markdown](https://getdotmd.com/guides/open-md-files-on-mac): open .md files and folders on a Mac, what renders, Quick Look.
  - [The editor](https://getdotmd.com/guides/edit-markdown-live-preview): edit Markdown with a live preview, search, export.
  - [Mermaid diagrams](https://getdotmd.com/guides/mermaid-viewer-mac): a Markdown viewer for Mac that draws Mermaid diagrams offline; write them with a live preview.
  - [Quick Look](https://getdotmd.com/guides/markdown-quick-look-mac): press Space on a .md file in Finder to preview it rendered; free.
  - [Markdown to PDF](https://getdotmd.com/guides/markdown-to-pdf-mac): export a Markdown file to PDF, HTML or rich text, with Mermaid diagrams and formulas drawn.
  - [Markdown diff](https://getdotmd.com/guides/markdown-diff-viewer): see what changed in a Markdown file as rendered text, compare versions, undo single changes.
  - [Math formulas](https://getdotmd.com/guides/markdown-math-latex-mac): LaTeX in Markdown rendered with KaTeX offline, with a cheat sheet.
  - [Markdown cheat sheet](https://getdotmd.com/guides/markdown-cheat-sheet): every Markdown element on one page, with what you type and what you get.
- [Use cases](https://getdotmd.com/use-cases): what DotMD is for and who uses it.
  - [Review AI specs](https://getdotmd.com/use-cases/review-ai-specs): review the specs, plans and docs AI agents write.
  - [Agent reviews agent](https://getdotmd.com/use-cases/agent-to-agent-review): one agent writes, another comments, you decide.
  - [Developers](https://getdotmd.com/use-cases/developers): review an agent's plan before it writes the code.
  - [Product managers](https://getdotmd.com/use-cases/product-managers): review PRDs and specs drafted with an AI agent.
  - [Technical writers](https://getdotmd.com/use-cases/technical-writers): review AI-written docs and READMEs, every version kept.
- [Compare](https://getdotmd.com/compare): DotMD next to Typora, Obsidian and Marked 2: price, platforms, comments, review of AI agent changes and MCP, with sources checked October 2026.
  - [DotMD vs Typora](https://getdotmd.com/compare/typora): Typora is a Markdown editor for Mac, Windows and Linux for $14.99 once; DotMD adds comments, review of agent changes and MCP.
  - [DotMD vs Obsidian](https://getdotmd.com/compare/obsidian): Obsidian is a free notes app with a vault of Markdown files; DotMD opens any .md file and reviews agent changes over its own MCP server.
  - [DotMD vs Marked 2](https://getdotmd.com/compare/marked): Marked 2 is a Mac Markdown previewer, not an editor; DotMD previews, edits and reviews in one window.
  - [Best Markdown apps for Mac](https://getdotmd.com/compare/best-markdown-apps-mac): Typora, Obsidian, Marked 2, MacDown 3000 and DotMD side by side, picked by what you do.
  - [DotMD vs MacDown](https://getdotmd.com/compare/macdown): the original MacDown's last release was in 2020; MacDown 3000 is the maintained fork; how DotMD differs.
- [Blog](https://getdotmd.com/blog): short Markdown how-to articles with copyable examples.
  - [AI spec review checklist](https://getdotmd.com/blog/ai-spec-review-checklist): a checklist for reviewing an AI-written spec or plan: scope, non-goals, edge cases, data, migrations, tests, rollback.
  - [PRD template](https://getdotmd.com/blog/prd-template-markdown): a copyable PRD template in Markdown for people and AI agents.
  - [CLAUDE.md vs AGENTS.md](https://getdotmd.com/blog/claude-md-vs-agents-md): which agents read CLAUDE.md or AGENTS.md, and how to keep one set of instructions.
  - [Mermaid flowcharts](https://getdotmd.com/blog/mermaid-flowchart): Mermaid flowchart syntax: directions, shapes, links, subgraphs, mistakes.
  - [Images](https://getdotmd.com/blog/markdown-images): image syntax, relative paths, size, alignment and captions.
  - [Code blocks](https://getdotmd.com/blog/markdown-code-block): fenced code blocks, language tags, nested backticks, inline code, diffs.
  - [Collapsible sections](https://getdotmd.com/blog/markdown-collapsible-section): collapsible sections with details and summary, the blank line rule, open by default.
  - [Markdown line breaks](https://getdotmd.com/blog/markdown-line-break): why a new line is ignored, and the three ways to force one: two spaces, a backslash or a br tag.
  - [Markdown task lists](https://getdotmd.com/blog/markdown-checkbox): checkbox syntax (- [ ] and - [x]), nesting, where it renders, checkmark characters.
  - [Markdown tables](https://getdotmd.com/blog/markdown-table): table syntax, alignment colons, escaping a pipe, a second line in a cell, wide tables.
- [FAQ](https://getdotmd.com/faq): every question on the site, by topic.
- [Release notes](https://getdotmd.com/release-notes): what is new in each version of DotMD, newest first.
- [Support](https://getdotmd.com/support): purchases and restoring DotMD Editor or Reviewer, reviewing with agents over MCP, files and version history, updates, refunds, privacy.
- [Privacy](https://getdotmd.com/privacy): what leaves your Mac, why, where it goes and for how long.
- [Terms](https://getdotmd.com/terms): the terms of use of DotMD and its purchases.