Problem description
MkDocs-2.0 was recently announced, and this has caused these warnings to appear:
│ ⚠ WARNING – MkDocs 2.0 is incompatible with Material for MkDocs
│
│ MkDocs 1.x is unmaintained. We recommend switching to Zensical, our
│ new static site generator, as soon as possible. We're providing an
│ analysis of the situation in this article:
│
│ https://squidfunk.github.io/mkdocs-material/blog/2026/02/18/mkdocs-2.0/
It seems like MkDocs-2.0 will not work with plug-ins anymore, and, since it is incompatible with MkDocs-Material, in the future we will either have to stay on MkDocs-1.x (which is unmaintained) or overhaul the documentation structure. MkDocs-Material suggests a switch to Zensical, which apparently only requires minor additions and updates to the documentation configuration.
Relevant people
@timlichtenberg @nichollsh
Problem description
MkDocs-2.0 was recently announced, and this has caused these warnings to appear:
It seems like MkDocs-2.0 will not work with plug-ins anymore, and, since it is incompatible with MkDocs-Material, in the future we will either have to stay on MkDocs-1.x (which is unmaintained) or overhaul the documentation structure. MkDocs-Material suggests a switch to Zensical, which apparently only requires minor additions and updates to the documentation configuration.
Relevant people
@timlichtenberg @nichollsh