Skip to content

DocsForge

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 docsforge gets 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, no extra_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

FeatureStatus
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

  •   Getting Started


    Installation, first steps, and basic configuration

  •   Setup Guides


    Customize colors, fonts, navigation, search, and more

  •   Reference


    Markdown syntax, components, and formatting options

  •   Blogging


    Set up a blog with authors, tags, and RSS feeds