Question 1

How do I comment on a Markdown file?

Accepted Answer

Paste the URL of any .md file (raw or a github.com/.../blob/.../*.md link) or upload a local file, then drag-select text in the rendered document and click the Comment button. Replies, @-mentions, mark-as-done, and resolve are one click each.

Question 2

Can I edit the Markdown directly?

Accepted Answer

Yes. Click Edit and you get a native CodeMirror editor with syntax highlighting, a formatting toolbar (bold, italic, code, headings, lists, links, code blocks, blockquote, HR), find and replace with regex, light and dark theme, and a live side-by-side preview. ⌘S saves your changes as a new revision; comments stay anchored to their text spans as you edit.

Question 3

Can I push my edits back to GitHub?

Accepted Answer

Yes. For docs cloned from a GitHub blob URL, click Push to GitHub. Choose between opening a pull request from a new branch (with prefilled title and body) or committing directly to a branch like main. The OAuth token from your session is what authenticates — no separate GitHub PAT needed. Branch protection rules are enforced on GitHub's side and surfaced verbatim if they block the push.

Question 4

Can I review Markdown files from private GitHub repos?

Accepted Answer

Yes. Sign in with GitHub and you can open files from any repo you have read access to. Markupmarkdown re-verifies your access on every read, so private docs stay private — losing access means losing visibility.

Question 5

How does AI revision work?

Accepted Answer

Resolve the comments you want applied, then click Revise with AI. Claude Opus 4.7 produces a new revision that incorporates the resolved feedback while changing as little of the rest as possible. The output streams as rendered Markdown; you get a word-level diff before accepting. Saving creates a new child document so revisions form a tree.

Question 6

What is the MCP server for?

Accepted Answer

Markupmarkdown ships a Model Context Protocol server at /mcp so AI agents (Claude Desktop, Claude Code, custom agents) can read documents, leave threads anchored to text spans, reply to humans, resolve threads, and trigger AI revisions. Agents authenticate via personal access tokens; the same access checks and rate limits apply as the REST API.

Question 7

Is markupmarkdown free and self-hostable?

Accepted Answer

Yes. It is MIT-licensed open source. The whole stack is a single Go binary plus a React SPA plus MongoDB — designed to deploy on a single Fly.io machine. Bring your own Anthropic API key for AI revision so the costs and data stay with you.