Zensical

In the light of the latest MkDocs developments, we've updated our plugin section to outline how we plan to reach feature parity as quickly as possible, and how MkDocs plugins relate to @Zensical modules. zensical.org/compatibility/…

We've just released Zensical 0.0.25, which includes several improvements for authoring and user experience, as well as accessibility. We're also making good progress on the module system, so shouldn't be long ☺️ github.com/zensical/zensi…

I will be on @TalkPython next week, talking about @zensical ☺️ youtube.com/watch?v=V1BvvI…

@mitsuhiko Not yet. We are working on it. Please understand that right now we're getting hammered with feature requests for the things that are not en par with Material for MkDocs yet. We're prioritizing things as they make sense. Swappable Markdown parsers will follow later this year.

@zensical Is there a way to opt into a different markdown parser for new docs?

I want to like Zensical for docs, but the markdown renderer they have is incompatible with what LLMs generate and what everybody else uses, and then list rendering is all broken all the time :(

@mitsuhiko Once we have CommonMark support, we'll provide automated tools to migrate from Python Markdown and escape the MkDocs trap. We're working as hard and fast as we can, as there's still some ground to cover. To those interested, our newsletter is here: zensical.org/about/newslett…

@mitsuhiko We're currently stuck with Python Markdown for compat reasons, which is not 100% compatible with CommonMark. This is a temporary limitation we need to endure to allow all users of MkDocs to switch to Zensical as soon as possible. Our phased transition: #phased-transition-strategy" target="_blank" rel="nofollow noopener">zensical.org/compatibility/…

We just delivered Zensical Monthly, January 2026 edition straight to your inbox with the latest and greatest updates to keep you informed on what's happening behind the scenes ☺️ We send 1 newsletter at the beginning of every month: zensical.org/about/newslett…

Adoption of @Zensical is growing fast, as we're already close to 100k monthly downloads! We're working hard on reaching feature parity within the coming months, so all Material for MkDocs users can switch to a maintained, modern docs stack 🚀 pypistats.org/packages/zensi…

Zensical 0.0.19 ships generation of objects.inv for mkdocstrings-powered documentation sites! github.com/zensical/zensi…

Making great progress on ZRX, the foundation for the module system that we're cooking up for @Zensical – it'll offer several degrees of freedom, and allow for type-safe composition (= plugin interop) – something that MkDocs (now dead) never delivered. github.com/zensical/zrx/r…

Zensical 0.0.17 brings support for automatic and manual API cross-references! Symbol names in your auto-generated API documentation will now link to the relevant section in your documentation. github.com/zensical/zensi…

MkDocs hasn't had a plugin system for the first three years. We're working very hard to deliver a battle-tested module system for @zensical.org this summer, at latest.

ZRX 0.0.7 makes selector matching 1,000 faster. We're currently working on a module system prototype, and selectors are the way how modules interconnect. This release lays the foundation for extremely large module graphs. github.com/zensical/zrx/r…

📮 The next edition of Zensical Monthly goes out tomorrow! We’ll be sharing the most important recent updates, behind-the-scenes work, and the occasional exclusive goodie! You can subscribe to Zensical Monthly here: zensical.org/about/newslett…

The documentation system dilemma: powerful but complex (Sphinx) or simple but limited (MkDocs). Why compromise? With Zensical, we're finally solving this. Full power, zero friction. Here's our roadmap: zensical.org/about/roadmap/

Migrating to Zensical from Material for MkDocs is simple 🚀

🎄 Merry Christmas 🎅 Zensical 0.0.15 brings fuzzy search support, and improves tooltip behavior on touch devices. The Zensical team wishes you a joyful holiday season and a fantastic new year! 🎄✨ github.com/zensical/zensi…

We'll soon ship support for fat fingers – aka fuzzy search. Fuzzy search is particularly tricky to get right, since enabling it generally deteriorates exact or prefix matches quite significantly. Disco only employs it as a fallback. No special syntax necessary.

⚠️ Warning We’ve been made aware of a crypto coin falsely using the name “Zensical.” To be clear: this is a scam, unauthorized, and not affiliated with us in any way. Please avoid and report.

Zensical 0.0.13 is out – our second release today. This release fixes all known issues in the user interface, which means we'll now focus again on the runtime, so we can start working on the module system very soon. github.com/zensical/zensi…