DocsForge
Write your documentation in Markdown. Build a professional static site in seconds. Deploy anywhere.
Coming from MkDocs?
DocsForge is the actively maintained successor to MkDocs + Material for MkDocs.
See the migration guide to convert your project manually.
pip install docsforge
docsforge serve
What makes DocsForge different
Zero Dependencies
Everything is bundled.
pip install docsforgegets you the engine, Material theme, all plugins, all extensions, fonts, icons, math rendering, and a service worker.Zero Config
Start with just
site_name:. All 8 core plugins and 36 Markdown extensions load automatically; social cards are opt-in. Customize only when you need to.Math Works
Write
$$...$$and it renders. KaTeX is vendored — no CDN calls for readers, noextra_javascript, no setup.Syntax Highlighted
Code blocks render with Pygments colors at build time. No client-side JavaScript needed.
Instant Search
Full-text search built in, powered by a client-side Marz index.
Dark Mode
Light/dark toggle in the header. Auto-detects system preference.
TikZ Diagrams
Write TikZ diagrams as
.texfiles. Auto-compiled to SVG at build time (requires a LaTeX toolchain).Blogging
Built-in blog with authors, tags, archives, pagination, and RSS feeds.
Offline Support
Service worker caches all assets. Works without an internet connection.
Quick start
pip install docsforge
docsforge # create a new project interactively
cd my-docs
docsforge serve
That's it. Your documentation site is now running at localhost:8000.
What you get
| Feature | Status |
|---|---|
Admonitions (!!! note) | Zero config |
Math ($$...$$) | Zero config |
| Code highlighting | Zero config |
| Tables | Zero config |
Task lists (- [x]) | Zero config |
Footnotes ([^1]) | Zero config |
| Definition lists | Zero config |
| Abbreviations | Zero config |
| Content tabs | Zero config |
| Diagrams (Mermaid, TikZ) | Zero config |
| Emojis | Zero config |
| Blog | Zero config |
| Tags | Zero config |
| Search | Zero config |
| Privacy (self-host assets) | Zero config |
| Minify (HTML/CSS/JS) | Zero config |
| Offline/PWA | Zero config |
Next steps
Installation, first steps, and basic configuration
Customize colors, fonts, navigation, search, and more
Markdown syntax, components, and formatting options
Set up a blog with authors, tags, and RSS feeds