| Date: | 2026-06-02 00:33 |
|---|---|
| category: | Tech |
| tags: | python, documentation, mkdocs, static-site-generator |
| summary: | MkDocs is no longer actively maintained. ProperDocs is the drop-in replacement community fork. Zensical is a new project with the same goal. |
MkDocs is no longer actively maintained. Two successors have emerged from the community: Zensical, a full rewrite with its own architecture and philosophy, and ProperDocs, a conservative fork that picks up exactly where MkDocs left off.
If Zensical's migration cost isn't worth it yet, ProperDocs is the answer.
Your mkdocs.yml, plugins, and themes all work without modification.
Switching is a two-step drop-in:
pip uninstall mkdocs pip install properdocs
Then replace mkdocs build / mkdocs serve with properdocs build /
properdocs serve. Done.
ProperDocs stays focused on bug fixes, dependency maintenance, and backward compatibility — no surprises, no breaking changes.