Repository navigation
Material for MkDocs is now in maintenance mode #67
Description
I noticed in PR #66 that the change log said Material for MkDocs is no longer supported. A snipet of the announcement is below:
This is the last release of Material for MkDocs that will receive new features. Going forward, the Material for Mk Docs team focuses on Zensical, a next-gen static site generator built from first principles. We will provide critical bug fixes and security updates for Material for MkDocs for 12 months at least.
Read the full announcement on our blog: https://squidfunk.github.io/mkdocs-material/blog/2025/11/05/zensical/
@normanlorrain, do you know if we are using Material for MkDocs? If so, we should look at migrating to Zensical or something else.
Activity
normanlorrain commentedon Dec 23, 2025
normanlorrain commentedon Jun 5, 2026
A full writeup of the issue is here.
The short story: MKDocs is the foundational project. "Material" provides the theme and extra functionality that we use. MkDocs development has been languishing, so the Material group has created a new project, Zensical. It's intended to be a drop in replacement. The last time I looked at it, there was a lot of progress but the weblog/posts functionality wasn't there yet.
I'm keeping an eye on it. For I think we should stick with MkDocs 1.x.
normanlorrain commentedon Sep 30, 2026
I've created a branch,
zensical
A work in progress. It builds fine with "uv run zensical serve". I've not tested the docker build or github pages.