docmd

Quick Start

Run docmd instantly in any folder with Markdown files:

npx @docmd/core dev

Starts: http://localhost:3000

That’s it.

• Navigation is generated automatically
• Pages render instantly
• Your docs are production-ready by default

Build your site:

npx @docmd/core build

Install for regular usage

npm install -g @docmd/core

Or run via Docker:

docker run -p 3000:3000 ghcr.io/docmd-io/docmd:latest

docmd dev     # start dev server
docmd build   # build for deployment

docmd migrate   # migrate from other documentation tools (like Docusaurus, VitePress, MkDocs, etc.)
docmd deploy    # instantly generate docker, nginx, or caddy configs

Features

Designed to start instantly and scale without friction.

Instant by default

• Automatic navigation from your files
• Zero configuration required
• Works directly with Markdown

Production-ready output

• Static HTML generation
• SEO optimised (sitemap, canonical, redirects)
• Tiny JavaScript payload

Built-in capabilities

• Internationalisation (i18n)
• Versioning
• Offline search
• PWA support
• Analytics
• AI context (llms.txt)

AI-First Integration

• Native MCP Server (docmd mcp) — AI agents search, read, and validate docs via stdio
• Agent instruction set (docmd-skills) — modular skills for LLMs and IDE agents
• llms.txt / llms-full.txt — full documentation context generated at build time
• Copy Markdown / Copy Context widgets — browser buttons optimised for AI chat

Extensible when needed

• Plugin support
• Custom configuration and navigation
• Theming
• Programmatic API

See the full roadmap.

Project Structure

Keeps your project simple.

my-docs/
├── docs/
├── assets/
├── docmd.config.json (optional)
└── package.json

Live Editor

A browser-based editor for writing and previewing docs instantly. No setup required.

Try it: live.docmd.io

Configuration (optional)

No configuration is required to get started.

Add a config file (docmd.config.json in the project root) only when you need more control.

const { defineConfig } = require('@docmd/core');

module.exports = defineConfig({
  title: 'My Project',
  url: 'https://docs.myproject.com',
});

Common options

module.exports = defineConfig({
  // Versioning
  versions: {
    current: 'v2',
    all: [
      { id: 'v2', dir: 'docs' },
      { id: 'v1', dir: 'docs-v1' }
    ]
  },

  // Internationalisation
  i18n: {
    default: 'en',
    locales: [
      { id: 'en', label: 'English' },
      { id: 'zh', label: '中文' },
    ]
  }
});

Built-in support for: English, Hindi, Chinese, Spanish, German, Japanese, and French. You can easily add and support any other language.

Other common settings include src, out, navigation, plugins, and theming.

Programmatic usage

Use in scripts or CI pipelines:

const { build, buildLive } = require('@docmd/core');

await build('./docmd.config.json', { isDev: false });
await buildLive();

Need more?

Full configuration, plugins, and advanced usage: docs.docmd.io

Plugin Ecosystem

Core functionality is included by default.

Everything works out of the box.

Plugins are only needed when you want to extend functionality.

Install optional plugins:

docmd add <plugin-name>

Why docmd?

Starts simple. Scales without friction.

Philosophy

Documentation tools should disappear.

Focus on writing, not setup.

No configuration overhead. No framework complexity. Just docs.

Community & Support

• Contributions are welcome. See CONTRIBUTING.md
• If you find it useful, consider sponsoring or starring the repo ⭐

License

MIT License. See LICENSE for details.