-
Notifications
You must be signed in to change notification settings - Fork 0
Open
Labels
questionFurther information is requestedFurther information is requested
Description
Building/serving a mkdocs site with Material recently yields message:
│ ⚠ 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/
The linked summary page in the warning promotes Zensical as their suggested migration/continuity approach.
Presently, it seems like the following options are on the table for consideration among:
- Pin mkdocs and Material dependencies accordingly.
- Migrate to Zensical.
- Adopt mkdocs 2.0 with another theme.
Currently, I believe starting with 1) and phasing to 2) is reasonable for least friction and ideal long-term support. Discussion welcome!
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
questionFurther information is requestedFurther information is requested