DotMD
Download for Mac Download on the Mac App Store

Support

Write to support@getdotmd.com and a person will answer, usually within two business days. Below are the things that come up most, with what to do about each.

Getting started

Where is the guide?

In DotMD, press ⇧⌘H or choose Help → DotMD Guide. It is also in Settings → About. The guide covers every feature, with the shortcuts.

Which version do I have, and where did it come from?

Settings → About shows the version. Whether DotMD came from the App Store or from getdotmd.com matters for purchases and updates: the App Store version updates through the App Store and has no Check for Updates item; the direct version has one in the DotMD menu.

DotMD can't open a file an agent mentions

DotMD opens only files it has access to: the folders in your workspace, Downloads and, if you allowed it, your Home folder (Settings → Files). Add the folder to the workspace (⌘O) and the agent can show you the file.

DotMD Pro and purchases

I have a new Mac, or reinstalled DotMD

Nothing to do if the Mac is signed into the same iCloud account: DotMD Pro comes back by itself. The purchase is tied to an anonymous ID that DotMD keeps in your iCloud, and both the App Store and the direct version read it. Give it a minute after the first launch. iCloud Drive doesn't need to be on; signing into iCloud is enough.

Pro didn't come back

How does the free trial work?

The Yearly plan starts with a free trial, once per customer. Everything is open during it; Settings shows the day it ends. If you don't cancel before that day, the subscription starts and the year is charged. Cancel at least 24 hours before the end to avoid the charge.

How do I cancel the Yearly subscription?

App Store: App Store → Account → Subscriptions, or DotMD → Settings → Manage Subscription, which opens the same place. Direct purchase: Manage Subscription in DotMD's Settings or the link in Paddle's receipt email. Cancel at least 24 hours before the period ends to avoid the next charge; Pro stays until the end of the period you paid for, and Settings then says "ends" instead of "renews".

I bought Lifetime and the subscription is still renewing

Buying Lifetime doesn't cancel a subscription in either store, so cancel it as above. DotMD shows a reminder in Settings until it's cancelled. If you were charged for a renewal after buying Lifetime, write to us and we'll sort it out.

Can I move from Yearly to Lifetime?

Yes: open DotMD → DotMD Pro… while subscribed and buy Lifetime; then cancel the subscription as above. Nothing is lost in between.

Refunds

App Store purchases are refunded by Apple at reportaproblem.apple.com. For a purchase on getdotmd.com, write to us within 14 days of the purchase (or of the first charge after a trial) with the order number from Paddle's receipt: full refund, no questions asked. Later requests are considered case by case. After a refund DotMD goes back to reading only.

App Store or direct: does it matter?

Same app, same price, same Pro. A purchase from either works in both. The direct version updates itself; the App Store version updates through the App Store.

I need an invoice

Direct purchases: Paddle's receipt email has a link to the invoice, and Paddle can add your company's details to it. App Store purchases: the receipt comes from Apple, in App Store → Account → Purchase History.

Reviewing with agents

How do I connect an agent?

Settings → MCP → MCP server; the status turns green. Then add the server to the agent: for Claude Code, claude mcp add --transport http dotmd http://127.0.0.1:8089/mcp; for Codex, Cursor, Visual Studio Code and others, the same URL in their MCP settings. The guide has the exact steps for each, including the Codex setting tool_timeout_sec, which must be long so the agent can wait for your review.

Claude Code · Codex · Cursor · MCP server

The agent doesn't see my comments

DotMD says "Waiting for review" but I see no comments to make

That's the agent waiting for you: it sent the document with request_review. Read it, comment where needed, then Send, or Approve if it's fine as is. Stop Waiting releases the agent without an answer.

The agent changed things I didn't ask for

Open the Review panel: changes no comment asked for are listed under Other changes. Every version of the file is in Version History (⌥⌘Y), so you can revert a single block or the whole file.

Recent Requests shows nothing, or shows requests in red

Nothing: the agent isn't reaching DotMD. Check the URL in the agent's settings, http://127.0.0.1:8089/mcp (the port is in Settings → MCP), and that DotMD is open: the server runs only while DotMD runs. Red: the request was refused, and the row says why; the usual cause is a file outside the folders DotMD may open (see "Getting started").

Port 8089 is taken

Change the port in Settings → MCP, turn the server off and on, and update the URL in the agent's settings.

My agent runs in Docker

From a container, use http://host.docker.internal:8089/mcp. Other computers can't reach the server: it listens on this Mac only.

Set up the MCP server

Files, editing and history

Where are my files and comments?

Your Markdown files stay where they are on disk; DotMD edits them in place and never copies them anywhere. Comments and version history live in DotMD's own storage in your user Library. Nothing is uploaded.

I need an earlier version of a file

Open the file and press ⌥⌘Y. Versions are listed by day, with what changed highlighted. Restore puts a version back; on the current version you can also revert one changed block. Older versions are thinned out the way Time Machine does, everything from the last day, then hourly, daily and weekly, up to 200 per file; the history of a file that has been gone for 30 days is removed. Version history is a convenience, not a backup.

What is the orange dot in the sidebar?

Another app, an agent, git, an editor, changed that file since you last opened it. Open it and DotMD shows the changes first; Done returns to normal reading.

Pasted images: where do they go?

Next to the document, in an assets folder, as PNG files. The Markdown gets a relative link, so the document stays portable.

A diagram or formula doesn't render

Mermaid and KaTeX are loaded from a content delivery network the first time they are needed, so the first render needs an internet connection. Check the syntax at mermaid.js.org or katex.org; DotMD shows the error text under the block.

AI actions

The AI menu says Apple Intelligence isn't available

Apple Intelligence needs macOS 26 and a Mac that supports it, turned on in System Settings. It also handles fewer languages and reads only the beginning of long documents. Without it, add a provider in Settings → AI: choose one, paste your own API key (it's stored in your Keychain) and press Test Connection.

Does an AI action send my document somewhere?

With Apple Intelligence, no: it runs on the Mac. With a provider, the selected text or the document goes straight from your Mac to that provider, under its policy, and only when you run an action. Nothing passes through us.

Updates

"Check for Updates" finds nothing, or the update doesn't install

The direct version checks getdotmd.com once a day and when you ask. If DotMD runs from the DMG or from Downloads, move it to Applications first: updates install there. If an update still fails, download the latest version from this site and replace the app; your files, comments and history are untouched. The App Store version updates through the App Store.

Privacy and data

What do you know about me?

For most people: nothing. If you bought Pro, a purchase record under an anonymous ID (plan, store, dates, country) and, for direct purchases, the email Paddle collected for the receipt. Details on the privacy page.

Delete my data

Write to us with your Paddle order number or App Store receipt. We delete the purchase record, which ends the Pro licence it carries. Your files and history are on your Mac and are yours to delete.

Uninstalling DotMD

Drag DotMD to the Trash. Your Markdown files are untouched. DotMD's own data, comments, history and settings, stays in ~/Library/Containers/com.sov.dotmd (in Finder: Go → Go to Folder…); delete that folder too if you don't plan to come back.

Still stuck

support@getdotmd.com

It helps to include DotMD's version and where it came from (App Store or getdotmd.com), your macOS version, what you did and what happened instead, and for purchase questions the Paddle order number or the App Store receipt. A screenshot of the Review panel or Settings → MCP → Recent Requests often says it all.