Quick Start
Run docmd inside any folder with Markdown files. No config file, setup, or framework knowledge required.
1. Start a dev server
npm
Bun
npx @docmd/core dev
bunx @docmd/core dev
This opens http://localhost:3000. Your documentation is live.
<img width=“500” class=“with-border” src=“/assets/previews/terminal-npx-dev.webp”>
Automatic Port Failover
If port 3000 is in use, docmd automatically finds the next available port (e.g., 3001).
2. Automatic features
The engine sets up everything automatically:
- Directory Detection: Scans for
docs/,src/docs/,documentation/,content/, or any.mdfiles in the project root. - Navigation Structuring: Builds a nested sidebar from your folder tree.
- Title Resolution: Extracts page titles from the first
H1tag automatically. - Search Indexing: Enables built-in full-text search immediately.
- Smart Caching: Triggers sub-200ms rebuilds instantly on file save.
No docmd.config.json is required. Add one later to customise layouts, plugins, or versions.
3. Build for production
Compile your Markdown files into a static, production-ready site.
npm
Bun
npx @docmd/core build
bunx @docmd/core build
The compiler outputs a static site to ./site/.
Host this static output anywhere. Deploy to GitHub Pages, Vercel, Netlify, or any static host.