MKDocs v1 is no longer maintained

[JC-wk]

Describe the bug
MKDocs v1 is unmaintained and v2 is being released with no plugin support

There are a few forks and drop in replacements, one of the MKDocs maintainers created ProperDocs which maintains compatibility.
https://github.com/orgs/ProperDocs/discussions/33

See also https://fpgmaas.com/blog/collapse-of-mkdocs/

The Material for MKDocs have also launched a documentation site zensical
https://squidfunk.github.io/mkdocs-material/blog/2026/02/18/mkdocs-2.0/

 │  ⚠  Warning from the Material for MkDocs team
 │
 │  MkDocs 2.0, the underlying framework of Material for MkDocs,
 │  will introduce backward-incompatible changes, including:
 │
 │  × All plugins will stop working – the plugin system has been removed
 │  × All theme overrides will break – the theming system has been rewritten
 │  × No migration path exists – existing projects cannot be upgraded
 │  × Closed contribution model – community members can't report bugs
 │  × Currently unlicensed – unsuitable for production use
 │
 │  Our full analysis:
 │
 │  https://squidfunk.github.io/mkdocs-material/blog/2026/02/18/mkdocs-2.0/

For now I'd suggest pinning mkdocs<2.0.0 and then considering alternatives