Dorcs
Dorcs turns a folder of Markdown files into a beautiful documentation website. One binary, zero dependencies — just write and ship.
Three commands. That’s it.
dorcs init # scaffold a docs site
dorcs --watch # start writing with live reload
dorcs build # export static HTML
What you get out of the box
Dorcs isn’t just a Markdown renderer — it’s a complete documentation platform:
- Beautiful themes with light and dark mode — see them all
- Automatically generated sidebar navigation from your folder structure
- Section tabs to organize large sites into top-level categories
- Breadcrumbs, previous/next links, and a back-to-top button
- Custom 404 page that matches your theme
- Tabs for platform-specific content (like this one!)
- Callouts for tips, warnings, and important notes
- Badges like NEW and BETA to label features
- Accordions for collapsible content
- Video embeds from YouTube and Vimeo
- Mermaid diagrams and KaTeX math
- Live reload — edit a file, browser updates instantly
- Clean URLs —
docs/guide/install.mdbecomes/guide/install - Built-in search with instant results
- Code copy buttons on every code block
- Heading anchor links for easy sharing
- Sitemap and Open Graph tags for SEO
- Multiple languages with automatic language switcher
- Doc versioning — maintain v1, v2, latest side by side
- GitHub integration — serve docs directly from a repo
- Browser-based editing with authentication
- Slide decks — turn any Markdown page into a presentation
- Static export — deploy anywhere as plain HTML
Where to start
Tip
New to Dorcs? Start with Getting Started — you’ll have a working site in under a minute.
Already set up? Jump to what you need:
- Writing Docs — how to structure your content and use all the Markdown features
- Customize Your Site — themes, branding, navigation, and more
- Deploy — ship your site to GitHub Pages, Netlify, or any host
- Commands — full CLI reference