Dorcs

Dorcs is a single-binary static documentation server for Markdown files. It is a simple and easy to use documentation server that allows you to create and host your documentation site in minutes.

Get Started

Ready to get started? Check out the Getting Started guide to have your documentation site running in under 5 minutes.

Or if you ready to get started now, download the latest release for your platform:

Documentation

• 🚀 Getting Started - Complete quick start guide
• 📦 Installation - Detailed installation instructions
• ⚙️ Configuration - Customize your site with dorcs.yaml
• 📁 File Structure - Organize docs with languages and versions
• 🔗 External Content - Serve content from external sources (GitHub, etc.)
• 🚢 Deployment - Deploy to production
• 🎨 Themes - Browse all available themes
• 📝 Markdown Features - Complete guide to markdown features

Features

• Single binary – no runtime dependencies, statically linkable
• Extensionless URLs – /guide/getting-started serves docs/guide/getting-started.md
• External Content Sources – serve markdown files directly from GitHub repositories with automatic caching
• Multi-lingual support – serve documentation in multiple languages with automatic language switching
• YAML front matter – metadata support (title, description, date, tags, draft)
• Table of Contents – auto-generated from headings with scrollspy
• Navigation sidebar – built automatically from your folder structure
• Responsive design – mobile-friendly with collapsible sidebar
• Dark mode – automatic based on system preference
• Live reload – watch mode for development with smart content updates
• Multiple themes – choose from 20+ built-in themes
• Search – built-in search functionality
• Edit Mode – online editing with authentication (create, edit, delete files directly in the browser)

How It Works

URL Routing

dorcs uses extensionless URLs that map directly to your file structure:

Multi-lingual URLs:

When multiple languages are configured, non-default languages use a language prefix:

The default language is served at the root URL (no prefix), while other languages use /{lang}/ prefixes.

Versioned URLs:

When versioning is configured, non-default versions use a version prefix:

Combined (Languages + Versions):

When both are configured, URLs use language-first structure:

See File Structure & Organization for complete details.

It will also automatically build navigation from your structure and generate a sidebar and a table of contents for each page.