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.
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/, or.mdfiles. - 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.