Zensical

Adaptive systems for evolving ideas – Zensical creates scalable Open Source systems for technical writing that always keep you in the flow

[Zensical @zensical]

🎙️ We were on @talkpython!

Episode #542 is live – Martin Donath (@squidfunk) joined @mkennedy to talk about the origin story of Zensical, how it differs from MkDocs, and what drove us to build it.

If you're curious about the "why", this is a good listen:
https://t.co/zUqNnyGLPL

[Zensical @zensical]

Zensical 0.0.44 brings further improvements to link validation. You might have noticed we've been quieter than usual – we've been heads down on a major milestone for Zensical. We'll share everything in Zensical Monthly, our newsletter, on June 10!

https://t.co/EMboERrh6j

[Sebastián Ramírez @tiangolo]

Now that I'm editing docs and seeing the change in the browser live, instantly... migrating to @zensical is so worth it ✨

[Sebastián Ramírez @tiangolo]

I just finished migrating all the open source docs from MkDocs to @zensical 🚀

@FastAPI was the last one.

The iteration (build) speed makes the developer / author experience so much nicer, so much more productive.

[Zensical @zensical]

Zensical 0.0.42 improves stability and accuracy of link validation, and fixes some bugs related to file watching, abbreviations in the table of contents, and GLightbox.

Release notes:
https://t.co/Rjl0fEiX5u

[Martin Donath @squidfunk]

Zensical Monthly 04/2026

AI agents don't stop when your docs have a gap. They guess – confidently, fluently, and wrongly. This month's Zensical Monthly is about what that means for technical writers, and what we're building about it.

Web version:
https://t.co/H8obX4p27z

[Zensical @zensical]

Zensical 0.0.40 is out with macro support. You can now use macros inside Markdown files and even docstrings – a much-requested feature that was never possible with mkdocs-macros.

Release notes:
https://t.co/jo8anuggCI

[Zensical @zensical]

Zensical 0.0.39 is out – a bugfix release smoothing out edges on link validation and the new lightbox integration.

https://t.co/rvHW8bTD3r

[Zensical @zensical]

Zensical 0.0.38 is out! 🎉 Link and footnote validation + strict mode are here – now catches broken links, unresolved references, and shadowed definitions at build time.

You'll probably catch and fix a few issues when upgrading. We did too! 🫣

https://t.co/0mmri8F51n

[Zensical @zensical]

Zensical 0.0.37 adds support for installable themes – you can now package your existing customizations into a theme that can be installed via pip exactly as with MkDocs.

Read the release notes:
https://t.co/YS16BsCXoZ

[Zensical @zensical]

Zensical 0.0.35 just arrived. What we shipped:

- 🌄 Image zoom + galleries with GLightbox
– 🏗️ Rich formatting in the table of contents
– 🔗 Resolution of relative links in raw HTML

Release notes:
https://t.co/ZmaaQ7DcNo

[Martin Donath @squidfunk]

Open Source software wins in the age of AI – not despite it, but because of it. Extensibility, transparency, and community ownership matter more than ever. It's at the core of everything we're building with @Zensical.

https://t.co/4G1mLBSmJV

[Zensical @zensical]

All issues of Zensical Monthly are now public. Catch up on anything you missed, or share an issue with your team:
https://t.co/XAhdyHGqgp

[Martin Donath @squidfunk]

ZRX 0.0.17 is out – the foundation of Zensical.

This one's a big deal – the module system is here, and with it a ground-up rewrite of the scheduler and stream crates. Three months of work. Phase 2 done. Phase 3 starts now.

Release notes:
https://t.co/BuCIoJit3y

[Zensical @zensical]

Zensical 0.0.30 adds a new floating table of contents menu on mobile/tablet, and ships support for our fork of "mike" – a tool that enables you to deploy multiple versions of your documentation to GH Pages.

Checkout the 0.0.30 release notes:
https://t.co/Tdmjw2t4o7

[Martin Donath @squidfunk]

Just finished the impl of a central module system concept: Specificity. If multiple selectors match a resource, ordering becomes important. This allows for super fine-grained module interdependencies 😎

Released as part of ZRX 0.0.15
https://t.co/NmEbYWoRl4

[Martin Donath @squidfunk]

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.

https://t.co/orMHsUTUOF

[Martin Donath @squidfunk]

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 ☺️

https://t.co/bvrGNlu167

[Martin Donath @squidfunk]

I will be on @TalkPython next week, talking about @zensical ☺️

https://t.co/JtfH4OF2UL

[Zensical @zensical]

@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.