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.

Originally published as GitHub Gist #9db6c291cbe3c5980bdc5afcbae218a4