You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
📌 DocsForge: The Actively Maintained Successor to MkDocs + Material for MkDocs #1
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
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.
Activity