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 7 plugins and 31 Markdown extensions load automatically. 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 Lunr.js index.
Dark Mode
Light/dark toggle in the header. Auto-detects system preference.
TikZ Diagrams
Write TikZ directly in Markdown. Auto-compiled to SVG at build time.
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