Write with people and agents in Markdown.

Margins is a collaborative document editor for Markdown. Humans and agents edit in realtime, comment, and suggest changes in the file format agents prefer.

Open Margins↗Explore the CLI↗

Realtime editing · Comments and suggestions · Clean Markdown

‹　›▧　launch-plan.md　×＋

JBAI✎◌2Share

PRODUCT · RELEASE

Launch plan

This document is the shared operating record for the release. Humans and agents work from the same Markdown, with every comment kept beside the writing.

What ships

The first release includes the public site, product documentation, onboarding, and a durable handoff for the launch agent.

Review the final product copy against source material.
~~Ship the migration on Thursday.~~Ship after Friday’s reliability review.
Leave the artifact ready for the next collaborator.

Young Girl Reading, Jean Honoré Fragonard, c. 1769. oil on canvas

ONE TASK THROUGH MARGINS

One document, two kinds of contributor.

A product manager opens proposal.md and asks an agent to review the rollout plan. The agent comments on one assumption and proposes replacement launch criteria.

The person accepts the patch. Margins updates the Markdown while the comment, suggestion, author, and checkpoint stay in structured review state.

01Open the Markdown
02Load document context
03Comment and suggest
04Review the patch
05Keep the clean file

Work together and keep the file.

Markdown is the format agents already read and write. Margins adds the collaboration people expect while the source remains a clean, portable .md file.

Your Markdown stays clean.

Comments, suggestions, anchors, checkpoints, authorship, and review state stay linked to the file without entering its body.

project/
  proposal.md
  runbook.md
  .mdocs/
    manifest.json
    docs/
    checkpoints/

People and agents share one review flow.

People work in the browser or desktop app. Agents use CLI or MCP commands to inspect the workspace, load context, add comments, propose changes, read history, and trace links.

↳Realtime multi-user editing and presence
↳Threaded comments and resolutions
↳Structured patch suggestions
↳Checkpoints and document history
↳Workspace maps and knowledge graphs
↳Agent-visible local images and attachments

Keep your library on your Mac.

The Margins desktop app mirrors the user’s library into ~/Margins/. Writers use the visual workspace while local tools and agents use the files. GitHub is optional.

Give agents the full document context.

The mdocs CLI and MCP server expose typed operations for workspace maps, document context, comments, suggestions, diffs, history, and images.

mdocs doctor --json
mdocs map --json
mdocs context docs/proposal.md --json
mdocs remote comment docs/proposal.md --range 3:5 --body-file comment.txt --json

Margins uses the Magic Markdown engine.

The app is called Margins. Its repository, engine, and @magic-markdown/cli package use the Magic Markdown name.

QUESTIONS, ANSWERED

What to know before you start.

01Is Margins a Markdown editor?＋

Margins is a Markdown workspace with editing, structured review, realtime collaboration, local mirroring, and agent access.

02Does Margins add hidden metadata to my Markdown?＋

No. Review and collaboration state stays outside the Markdown body.

03Is GitHub required?＋

No. GitHub sync is optional.

04Why does the repository say Magic Markdown?＋

Margins is the app. Magic Markdown names the repository, engine, and CLI package.

Margins

START HERE

Start with Margins.

Open Margins↗