Autorefs are now workspace symbols in Zensical Studio! They support completion, diagnostics, navigation, incoming-reference counts, rename, and safe updates across the entire project. Zensical Studio is available for VS Code: zensical.org/studio/
Zensical
@zensical.org
Adaptive systems for evolving ideas – Zensical creates scalable Open Source systems for technical writing that always keep you in the flow https://zensical.org
Never break anchor links again. Zensical Studio 0.2.6 tracks every addressable Python Markdown element, including headings, attribute lists, and HTML IDs. Rename an anchor or edit and save it, and incoming links update automatically. zensical.org/studio/
Zensical 0.0.52 is out! 🇨🇳🇯🇵🇰🇷 Search now supports Chinese, Japanese, and Korean through locale-aware word segmentation. The release also includes a larger search modal, improved keyboard key styling, and 56 new icons. Release notes: github.com/zensical/zen...
Release 0.0.52 · zensical/zensical
Summary This version adds search support for CJK languages: Chinese, Japanese, and Korean. Search needs to segment text into individual words before it can index and match them. While many language...
github.com
1/2 Zensical Studio 0.2.0 provides a live Markdown preview for Zensical and MkDocs projects, powered by our Rust-based Python Markdown renderer. It updates as you type, supports navigation, and stays synchronized with your editor. zensical.org/studio/
Material for MkDocs proved the value of Python Markdown for technical writing. With Zensical, we’re now integrating the layers around it: parser, editor tooling, build, and publishing. We’ll share more in tomorrow’s newsletter. zensical.org/about/newsle...
Zensical Studio now resolves definitions across snippet! A link reference in one file can jump straight to the definition inside a snippet, even through nested includes. This is the kind of workspace-level Markdown intelligence we wanted from day one. 1/5 🧵
Sneak peek: Python Markdown snippets as first-class symbols in Zensical Studio. Rename a snippet – every inclusion site updates. Type-safe content reuse, finally. 🎯 ➡️ zensical.org/studio/
Zensical Studio 0.1.2 adds syntax support for snippets, icons/emojis, smart symbols, keyboard keys, inline math, and lists, and improves nested highlighting, e.g., in link titles. It's now higher-fidelity than VS Code's Markdown extension. Release notes: github.com/zensical/stu...
Zensical v0.0.46 is out: search results now include excerpts, the UI was updated, and we also shipped several bug fixes. We now disabled some legacy reference checks by default while we move toward Zensical Studio's new Markdown parser. Release notes: github.com/zensical/zen...
Zensical Studio v0.1.1 just dropped, and it brings a wide range of improvements for highlighting! Update your VS Code extension, or enable auto-update to immediately benefit from future improvements. github.com/zensical/stu...
Release 0.1.1 · zensical/studio
Summary This version significantly improves Python Markdown highlighting in Visual Studio Code. It adds support for emphasis, strong emphasis, and mixed emphasis nesting, while fixing a broad range...
github.com
Today, we're launching Zensical Studio, the missing productivity layer for Docs-as-Code. The idea is simple: Refactor documentation like code. Rename headings safely. Catch [broken links] instantly. Works with Zensical and MkDocs projects. zensical.org/studio/
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! github.com/zensical/zen...
Release 0.0.44 · zensical/zensical
Summary This version fixes several bugs related to link validation and macros, and ensures that dotfiles are not removed from the site directory during generation. Changelog Bug fixes eb72115 comp...
github.com
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: github.com/zensical/zen...
Release 0.0.42 · zensical/zensical
Summary This version includes a number of bug fixes and refactorings to improve the stability and accuracy of link validation, and fixes a reload loop when the custom_dir, which is auto-watched, is...
github.com
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: mail.zensical.org/monthly/2026...
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: github.com/zensical/zen...
Release 0.0.40 · zensical/zensical
Summary This version adds support for macros, covering the functionality of the mkdocs-macros-plugin. Macros allow you to define custom variables and functions that can be used in your Markdown fil...
github.com
Zensical 0.0.39 is out – a bugfix release smoothing out edges on link validation and the new lightbox integration. github.com/zensical/zen...
Release 0.0.39 · zensical/zensical
Summary This version fixes several bugs related to link validation and lightbox configuration. Changelog Bug fixes fe42fc4 compat – shim for MkDocs validation syntax overrides Zensical's (#607) ac...
github.com
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! 🫣 github.com/zensical/zen...
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: github.com/zensical/zen...
Release 0.0.37 · zensical/zensical
Summary This version adds support for installable themes. You can now bundle your theme overrides and package them into a custom theme which can be installed via pip. As of now, we closely mirror t...
github.com
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: github.com/zensical/zen...
Release 0.0.35 · zensical/zensical
Summary This version adds native support for GLightbox, a JavaScript lightbox library to add zoom and gallery features to images. Images can be automatically annotated with the new glightbox Markdo...
github.com
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.org.
A letter to tech CEOs
YouTube video by Theo - t3․gg
youtube.com
All issues of Zensical Monthly are now public. Catch up on anything you missed, or share an issue with your team: zensical.org/about/newsle...
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: github.com/zensical/zrx...
Release 0.0.17 · zensical/zrx
Summary This version ships the initial version of the module system and includes a ground up rewrite of zrx-scheduler and zrx-stream to support it. Together with the fundamental changes made to zrx...
github.com
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: github.com/zensical/zen...
🎙️ We were on @talkpython.fm! Episode #542 is live – Martin Donath (@squidfunk.com) joined @mkennedy.codes 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: talkpython.fm/episodes/sho...
Zensical - a modern static site generator
If you've built documentation in the Python ecosystem, chances are you've used Martin Donath's work. His Material for MKDocs powers docs for FastAPI, uv, AWS, OpenAI, and tens of thousands of other pr...
talkpython.fm
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 github.com/zensical/zrx...
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.org modules. zensical.org/compatibilit...
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/zen...
Release 0.0.25 · zensical/zensical
Summary This version updates the user interface to v0.0.9, which improves on accessibility and fixes some minor rendering issues. Additionally, it fixes some bugs related to configuration parsing a...
github.com
I was running up some doco on MKDocs earlier this week and then found @zensical.org this morning. It took about 4 minutes to change over and it looks fantastic out of the box. Confluence -> confluence-markdown-exporter -> zensical Perfect.
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/newsle...
