MarkDocs

Self-hosted collaborative markdown editor with real-time editing, comments, suggestions, MCP tools, and a CLI.

Quick Start

git clone https://github.com/thakurkharel/markdocs.git
cd markdocs
cp .env.example .env
docker compose up -d

Open http://localhost:3001  and create your account.

Features

• Real-time collaboration — Live cursors, presence, conflict-free editing via Yjs
• Comments & suggestions — Threaded comments with replies, inline suggestions with accept/reject
• MCP server — 23 tools over stdio for AI agents
• CLI — Manage docs, comments, suggestions, and sharing from the terminal
• Self-hosted — Docker Compose, PostgreSQL, your infrastructure
• Sharing — Per-document access control with editor/viewer roles
• Edit history — Provenance tracking with author attribution

Next Steps

• Getting Started — Deploy and create your first document
• Agent Setup — Set up an AI agent with MarkDocs
• CLI — Command reference
• MCP Server — Connect AI agents
• Self-Hosting — Production deployment
• Architecture — How it works