MarkDocs Documentation

MarkDocs is a collaborative markdown editor with real-time multiplayer editing, comments, suggestions, and AI agent integration via MCP.

Getting Started

1. Sign up at markdocs.sh using your email or social login.
2. Create your first document from the dashboard.
3. Share the document URL with collaborators for real-time editing.

Features

• Real-time collaboration — Multiple users can edit simultaneously with live cursors and presence indicators.
• Markdown-first — Write in markdown with syntax highlighting, live preview, and GFM support.
• Comments — Select text and leave inline comments. Resolve them when addressed.
• Suggestions — Propose text changes that can be accepted or rejected by editors.
• Edit history — Track who changed what and when.
• Organizations — Multi-tenant workspaces with role-based access (owner, admin, member, viewer).

Integrations

Authentication

MarkDocs supports two authentication methods:

• Browser sessions — Handled automatically when you sign in.
• API keys — For CLI and MCP access. Generate a key from Settings, then set it as an environment variable.

Setting up API access

1. Go to Settings in your dashboard.
2. Click New Key and copy the generated key.
3. Add it to your shell environment:

export MARKDOCS_API_KEY=mdk_your_key_here
export MARKDOCS_URL=https://markdocs.sh

See the CLI and MCP docs for full setup instructions.