Skip to content

Goodbye MkDocs, Hello Zensical!

I have been using Material for MkDocs nearly since I started using Python and I have always loved it. However, the underlying framework, MkDocs, has been going through some drama. The latest version (v1.6.1) was released in August 2024, and the next planned version (v2.0) is expected to remove plugin support, which is one of the main appeals of MkDocs.

Luckily, the Material for MkDocs team has been working on a new framework called Zensical, built from scratch, compatible with Material for MkDocs. It was announced in November 2025 and it has been steadily incorporating all the features of Material for MkDocs. I have been slowly migrating my old sites to Zensical, but the two plugins I was waiting for were the blog and RSS plugins, which were just released in v0.0.64 and v0.0.65 respectively.

So here we are, my blog is now running on Zensical! The migration is as easy as installing the new package and using zensical build instead of mkdocs build.

I'm looking forward to seeing how Zensical evolves. I still have a few websites to migrate, but I will get there!

Comments