mastodon 4.7.3Adaptive systems for evolving ideas – Zensical creates scalable Open Source systems for technical writing that always keep you in the flow
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://github.com/zensical/zensical/releases/tag/v0.0.37
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://github.com/zensical/zensical/releases/tag/v0.0.40
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://github.com/zensical/zensical/releases/tag/v0.0.35
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://github.com/zensical/zensical/releases/tag/v0.0.30
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://mail.zensical.org/monthly/2026/04/index.html
🎙️ We were on @talkpython@fosstodon.org!
Episode #542 is live – Martin Donath (@squidfunk@fosstodon.org) joined @mkennedy@fosstodon.org 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://talkpython.fm/episodes/show/542/zensical-a-modern-static-site-generator
Zensical 0.0.39 is out – a bugfix release smoothing out edges on link validation and the new lightbox integration.
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 0.0.19 ships generation of objects.inv for mkdocstrings-powered documentation sites!
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.
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.
📮 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:
https://zensical.org/about/newsletter/
