Tell us more.

Summary

You're using Material for MkDocs 9.7.0 to build the documentation site. 9.7.0 is the final version, the project is in maintenance mode. It will get security updates for 12 months.

I recommend migrating from Material for MkDocs to Zensical. Zensical is from the same developers, builds on the things we like already, and is built as the replacement.

Todos

• Remove dependencies for Material for MkDocs and MkDocs.
• Remove dependencies for custom bits of Material for MkDocs.
• Install dependencies for Zensical.
• Confirm code that autogenerates parts of the documentation still works, fix it if needed.
• Convert mkdocs.yml to the new Zensical TOML format (technically optional, but I still recommend updating to the new format).
• Remove custom styling, try the baseline from Zensical first.

Official announcement from Material for MkDocs ¹

First snippet:

9.7.0, the final version of Material for MkDocs, includes all features that were previously exclusive to sponsors, making Material for MkDocs Insiders available to everyone!

As we're shifting our efforts to Zensical, Material for MkDocs is entering maintenance mode. This means that while we'll continue to fix critical bugs and security issues for 12 month at least, no new features will be added to Material for MkDocs.

We're also discontinuing our sponsorware model, saying goodbye to GitHub Sponsors. If you were a sponsor of our work, you already received an email mentioning that your sponsorship was cancelled. As one of the numerous individuals and organizations sponsoring Material for MkDocs over the past years – thank you! Your continued support has been invaluable.

Now, we want everyone to benefit from all features we have developed for Material for MkDocs, which is why we're making all Insiders features available to everyone!

This is the logical next step in our journey as we focus on Zensical – our next-generation static site generator built from the ground up to overcome MkDocs' technical limitations. Zensical is fully Open Source, licensed under MIT, maintains compatibility with Material for MkDocs, and can build your existing projects with minimal changes.

In the coming months, we'll close the feature parity gap, bringing the expressiveness of Material for MkDocs to Zensical.

Material for MkDocs maintainers recommend migrating to Zensical

We want to be transparent about the risks of staying on Material for MkDocs. With MkDocs unmaintained and facing fundamental supply chain concerns, we cannot guarantee Material for MkDocs will continue working reliably in the future. We're aware that transitioning takes time, which is why we commit to support it at least for the next 12 months, fixing critical bugs and security vulnerabilities as needed, but the path forward is with Zensical.

If documentation plays a critical role in your organization, and you're worried how this might affect your business, consider joining Zensical Spark, or feel free to schedule a call by reaching out at contact@zensical.org.