Documentation for humans
and machines.
Open source documentation compiler. One Markdown source, one command – generates website, search, AI context, agent protocols, and knowledge formats. All together.
$ npx @docmd/core dev # Initialising docmd compiler in /docs... ✓ Discovered 16 Markdown source files ✓ Generated static HTML + client-side vector search index ✓ Exported llms.txt, llms-full.txt & OKF graph bundles ✓ Built production documentation in 240ms – Lighthouse 100/100 → Dev server running at http://localhost:3000
Everything works out of the box.
Search, SEO, themes, and AI tooling built in. Add only what you need.
Write Markdown, Get a Website
Point docmd at any folder of Markdown files. It builds a complete documentation site instantly – with navigation, hot-reloading, and zero configuration needed.
✓ Generated 12 pages in 340ms (Lighthouse 100)
Native AI Agent Support
Expose your docs to AI coding assistants like Claude, Cursor, and Windsurf through a built-in MCP server and auto-generated context files.
Built-in Search, Zero Cloud Costs
Semantic and keyword search compiled at build time into local index files. Runs entirely in the browser – no cloud APIs, no hosting costs.
Native MDX & Interactive JSX
Author documentation with JSX components (
Variables & Runtime Personalisation
Interpolate environment keys, git commits, build versions, and reactive client variables like API keys and user tokens with zero runtime overhead.
Rich Content from Plain Markdown
Prefer standard syntax? Write callouts, tabbed code blocks, warning boxes, cards, and diagrams without any HTML or setup.
Native Markdown callouts & tabs!
:::
Interactive Code Sandboxes
Embed runnable JavaScript sandboxes and live HTML component previews directly in Markdown with instant console output.
<button class="btn">Run</button>
:::
100k+ On-Demand Dynamic Icons
Embed icons from Material, Carbon, Lucide, FontAwesome and 100+ open icon sets with @docmd/plugin-iconify. SVGs inlined on demand during build with zero client bundle bloat.
Modular plugin ecosystem
Each plugin works out of the box with zero configuration. Enable only what you need.
Offline Vector Search
Semantic and keyword search that runs entirely in the browser.
Native MDX & JSX
Interactive JSX components and dynamic expressions with zero client runtime.
AI Assistant
AI assistant that answers questions using your documentation as context.
OpenAPI & Swagger Docs
Generate interactive API reference pages from OpenAPI spec files.
Interactive Playground
Runnable JavaScript sandboxes and live HTML component previews.
Mermaid Diagrams
Flowcharts, sequence diagrams, and architecture maps from Markdown.
Git History & Edits
Page edit links, contributor metadata, and last-modified timestamps.
SEO & Schema JSON-LD
Sitemaps, meta tags, and structured data for search engine visibility.
Dynamic Sitemap
Automated XML sitemaps keeping search crawlers synchronized.
Privacy Telemetry
Privacy-first documentation metrics with Google Analytics 4 integration.
AI Context Generator
Auto-generate llms.txt, llms-full.txt, and SKILL.md for AI tools.
Open Knowledge Format
Deterministic knowledge bundles structured for LLM ingestion.
Iconify Dynamic Icons
100,000+ icons from 100+ open-source sets inlined on demand as SVGs.
KaTeX Maths
Render LaTeX mathematical expressions with lightweight KaTeX.
PWA & Offline Cache
Service worker and web app manifest for instant offline navigation.
Collaborative Threads
In-page annotations, inline discussions, and reader feedback.
Built for autonomous AI coding agents.
Expose your documentation to Claude, Cursor, Windsurf, and custom LLMs through open machine-readable standards.
Native MCP Server
Allows Claude Desktop, Cursor, and Windsurf to search, inspect, and read your docs directly over stdio or SSE.
llms.txt & llms-full.txt
Generates standard LLM feeds so any language model can ingest your full documentation in one request without web scraping.
Agent Skills (SKILL.md)
Packages actionable CLI workflows, architecture rules, and code patterns into discoverable skill files for coding agents.
Open Knowledge (okf.yaml)
Compiles docs into machine-readable ontology tags, concept graphs, and semantic bundles for multi-agent workflows.
Add AI assistant capabilities to your docs with free docmd Cloud Relay
Connect in seconds with GitHub. Get real-time search analytics, uncover missing documentation gaps, and proxy AI assistant queries securely.
- AI Assistant Proxy – BYOK routing for 100+ LLMs without exposing API keys.
- Documentation Analytics – Discover top queries, volume trends, and content gaps.
- Free & Serverless – Connect in seconds via GitHub with zero maintenance.
Built in the open. Owned by developers.
Documentation belongs in Git, not behind proprietary SaaS walled gardens.
“Your documentation is the intellectual heart of your project. It belongs as plain Markdown files in your Git repository – permanent, version-controlled, auditable, and free forever. docmd will always be 100% MIT licensed with zero paywalled compiler features.”
Data Sovereignty
Your documentation is plain Markdown in your Git repo. No proprietary databases or schemas. If you ever switch, you take all your content with you cleanly.
Zero Vendor Lock-in
Compile to standard static HTML. Host on any static cloud or CDN for $0. Zero monthly fees, zero runtime dependencies, zero surprises.
Permissive MIT License
Free for personal, open-source, and commercial use. Built by engineers who believe documentation infrastructure should be open to all.
Built together with the open source community
Powered by independent developers, code contributors, and sponsors around the world.
Help keep docmd 100% free and open source. All sponsor funds directly support ongoing compiler performance, agent protocol standards, and serverless relay infrastructure.
Frequently asked questions
Everything you need to know about docmd.
What is docmd?
How is docmd different from Docusaurus, MkDocs, or VitePress?
Do I need React or any front-end framework?
How does AI agent integration work?
llms.txt and SKILL.md files so any language model can understand your docs.What are Agent Skills (SKILL.md) and how do I install them?
npx docmd-skills [target-directory]
Start building in minutes
Open source, MIT licensed. One command to your first documentation site.