📌 DocsForge: The Actively Maintained Successor to MkDocs + Material for MkDocs

[QQSHI13]

DocsForge: The Actively Maintained Successor to MkDocs + Material for MkDocs

The Problem

• MkDocs: Last meaningful release was over a year ago. The project is effectively unmaintained.
• Material for MkDocs: Entered maintenance mode. No new features, only critical bug fixes.
• Community impact: Thousands of documentation sites depend on these tools. Security patches, new Markdown extensions, and theme improvements have stalled.

The Solution

DocsForge is a self-contained, actively-maintained fork that preserves everything you love about MkDocs + Material while adding modern features:

Feature	MkDocs + Material	DocsForge
Maintenance	⚠️ Unmaintained / maintenance-only	✅ Actively developed
Installation	pip install mkdocs-material + plugins	pip install docsforge — everything included
CDN calls	Google Fonts, KaTeX, Mermaid from CDN	🔒 Zero external network calls
Math rendering	Requires internet or manual setup	✅ KaTeX vendored, works offline
PWA / Offline	Not included	✅ Service worker + offline cache built-in
Privacy	External requests on every build	✅ All assets self-hosted

Migrate in One Command

pip install docsforge
docsforge migrate   # converts mkdocs.yml → docsforge.yml
docsforge build     # builds your site
docsforge serve     # live preview

Full migration guide →

What You Get

• 31 Markdown extensions pre-configured (pymdownx + python-markdown)
• 7 built-in plugins: search, tags, blog, info, meta, minify, privacy
• KaTeX math, Mermaid diagrams, TikZ diagrams — all vendored, no CDN
• 14,000+ icons included
• Dark mode with system detection
• Offline PWA with versioned service worker
• Self-hosted fonts (privacy plugin downloads Google Fonts locally)

Compatibility

DocsForge reads existing mkdocs.yml files as a fallback. If you haven't migrated yet, docsforge build will still work — but you'll see a friendly reminder to run docsforge migrate.

Most MkDocs plugins work out of the box. The migration command analyzes your plugins and reports which are supported and which need attention.

Get Involved

• 📖 Documentation
• 📦 PyPI
• 🐙 GitHub

---

DocsForge is built by QQ (Cyrus) and Nova ☄️ — because documentation tools should just work.