Studio has crossed 1,000 weekly active users! 🚀 Four months into our beta, it's great to see Studio becoming part of more technical documentation workflows. Thanks to everyone using Studio, sharing feedback, and helping us make it better for everyone ❤️ zensical.org/studio/
Martin Donath
Martin Donath
@squidfunk.com
Founder of @zensical.org, creator of Material for MkDocs
450 followers12 following246 posts
Material for MkDocs 9.8.0 raises dependency minimums to address known vulnerabilities. Python 3.11+ is now required. Please upgrade and update your lockfiles. Critical maintenance continues until May 5, 2027. github.com/squidfunk/mk...
We're putting the finishing touches on Zensical 0.1.0, just two weeks away! This release brings another round of MkDocs compatibility improvements as we remove the remaining differences in behavior. Very excited for what's coming!
Zensical 0.0.72 brings behavior very close to Material for MkDocs: privacy plugin, fenced code blocks by default, and fixes for links and Markdown extension ordering among many others. Release notes: github.com/zensical/zen...
Martin Donath reposted
Zensical 0.0.68 is out, adding support for audio and video. github.com/zensical/zen...
In this week's Zensical Monthly, we'll share more on Spark Community, launching November 5. We're rebuilding Spark from scratch for great UX, fast feedback, Open Source collaboration, and early access – shaped by a decade of building in the open. zensical.org/about/newsle...
Zensical's logo got accepted into Simple Icons! This means you'll be able to use it in badges once the next version is out ☺️ github.com/simple-icons...
MkDocs 1.x is now closed to outside contributions. Meanwhile, six new MkDocs 2.0 pre-releases have been published to PyPI. We've updated our article to reflect the latest developments, what they may mean for your projects, and how you can start planning: squidfunk.github.io/mkdocs-mater...
Martin Donath reposted
Zensical 0.0.67 is here ✨ MkDocs-compatible social cards lead this release, alongside exclude and llmstxt plugins. Enjoy! Release notes github.com/zensical/zen...
Working hard on the new Zensical Spark experience – just one more month until Spark Community launches on November 5! 🤫 One of the first members-only early-access features will be our new Rust-based Markdown parser. Builds are about to get fast. ⚡ zensical.org/spark/
Full circle! 🔄 Python-Markdown – the very foundation MkDocs was built on – is now using Zensical for its own documentation 💛 python-markdown.github.io
Big thanks to all individuals who have already reserved Studio Pro / Studio Pro + Spark Community! ❤️ Your contribution helps us make Zensical sustainable and stay independent, so we can keep building it in the open without having to compromise. 🚀 zensical.org/upcoming-cha...
🤫 If you'd like to support our work – and get a really nice editing experience for Zensical and MkDocs, plus early access to what we're building next – check out our early supporter offer for Studio Pro and Spark Community 🚀 zensical.org/upcoming-cha...
Martin Donath reposted
Many of you have been waiting for this one: Zensical 0.0.64 ships a drop-in replacement for the Material for MkDocs blog plugin – enjoy! github.com/zensical/zen...
5x faster. 80% fewer tokens. Agents should edit intent, not chase references. In three paired runs, Studio also cut direct file edits by 90% while updating every affected link. We're bringing this to Zensical Studio in the coming weeks. zensical.org/studio/
Pretty happy with how yesterday went, and we're already back at it ☺️ Just released: 0.2.17 makes Connections easier to explore: – Expand all connections – Open targets directly or to the side – Reveal assets in your file explorer zensical.org/studio/
We've put a lot into this – really happy to finally share it with you ☺️
On November 5, we'll ship Zensical 0.1.0, move Studio out of beta, and open Spark Community to individuals. Zensical remains free and Open Source, forever. Here's what changes – and what stays the same: zensical.org/upcoming-cha...
We are extending critical maintenance for Material for MkDocs by six months, through May 5, 2027. This gives you more time to evaluate the migration path, test Zensical with your existing projects, and plan a controlled transition. github.com/squidfunk/mk...
After link validation, this is probably one of the most useful features we've added to Zensical Studio. Keeping incoming links intact as documentation evolves sounds simple, but involves many interesting edge cases. This was a lot of fun to build.
Zensical 0.0.61 adds anchor redirects, so incoming links and bookmarks keep working when headings change or content moves. Zensical Studio now suggests redirects for renamed headings and keeps mappings up-to-date for you. Enjoy your weekend! github.com/zensical/zen...
Great movie, even better soundtrack www.youtube.com/watch?v=Oee5...
I really love where this is going: one unified model of your entire documentation project, from Markdown content to configuration.
Project configuration is source code, too. Zensical Studio now completes and validates mkdocs.yml and zensical.toml, shows previews for navigation items, and keeps paths synchronized when pages move. zensical.org/studio/
That was a lot of work, but I’m very happy with where we landed. 6 MkDocs plugin replacements, a much more efficient build architecture, and a solid foundation for what comes next!
Zensical 0.0.58 is out – our largest compatibility and workflow update yet + 6 MkDocs plugin replacements: - meta - redirects - minify - tags - literate-nav - awesome-nav Peak memory use is cut by 30–40%, with the biggest gains on larger projects. github.com/zensical/zen...
Exactly two years after MkDocs 1.6.1 – the last release of the original MkDocs lineage – there's now an installable MkDocs 2.0 pre-release on PyPI. MkDocs 2.0 is being developed as a ground-up rewrite with a fundamentally different architecture. pypi.org/project/mkdo...
Martin Donath reposted
Zensical Studio now treats your nav configuration as part of the documentation workspace. Complete pages as you type, catch invalid entries immediately, and keep navigation paths correct when files move. Works with Zensical and MkDocs projects. zensical.org/studio/
We're building Zensical Studio to make the relationships between Markdown pages, reusable content, and assets much easier to understand ☺️
Zensical Studio's new Connections view helps you explore the current documentation's relations: 🔗 Incoming and outgoing links 🖼️ Images and other assets used by a page 💣 Invalid links and unresolved references zensical.org/studio/
Extremely useful and surprisingly satisfying to watch 60 broken links magically being repaired at once 🪄
When you open Zensical Studio this morning, you’ll find that broken links now show hover previews and have a new "repair" code action. The video shows: → Preview repair candidates → Repair 1 broken link → Repair 60 broken links at once zensical.org/studio/
Zensical Studio already prevents broken links. Next week, it will help you repair the links that somebody else broke. 😎 zensical.org/studio/
Martin Donath reposted
Zensical 0.0.54 is out! – 8-10x reduction in peak memory usage – Invalid autorefs now caught in validation – Better integration with mike (versioning) Release notes: github.com/zensical/zen...
Martin Donath reposted
We just delivered the Zensical Monthly, July 2026 edition to your inboxes – The tight authoring loop – featuring: Markdown Preview, Markdown Formatter, our new Directives Extension, and more. mail.zensical.org/monthly/2026... Subscribe to Zensical Monthly: zensical.org/about/newsle...
If you work in a large documentation project, the latest Zensical Studio update should feel quite different. Startup, link intelligence, workspace symbols, and diagnostics have all received substantial performance work 🚀
50,000 documents indexed in under 8 seconds. The latest Zensical Studio release improves indexing performance for large documentation workspaces. Recorded on a MacBook Pro (M2) from '22. zensical.org/studio/
Martin Donath reposted
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/
We keep shipping – Zensical Studio 0.2.6 makes anchors first-class workspace symbols: navigate, validate, rename, and automatically update incoming links across your entire documentation project. Documentation, refactored like code.
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/
Martin Donath reposted
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...
Codeberg now bans projects that mostly consist of AI-generated code. It's not yet clear where the line between AI-assisted and AI-generated projects will be drawn, and how it will be enforced. www.youtube.com/watch?v=Y8cY...
👀 Sneak peek: A Markdown formatter that understands Python Markdown - natively: ✨ Format on save (or edit) ⚡ Extremely fast – written in Rust 🏗️ Integrated into Zensical Studio 👯♀️ Works with Zensical and MkDocs projects More about Zensical Studio: zensical.org/studio/
Edit a headline, save – 10 incoming links updated automatically. No need to remember updating them manually. That's Zensical Studio – @zensical.org. Zensical Studio is in public beta and available here: zensical.org/studio/
A much-requested feature is here: Zensical Studio 0.2.0 now provides a live, interactive Markdown preview. It also works with your existing MkDocs projects ☺️
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 9.7.7 is out. It fixes a DOM-based XSS issue in the optional search.suggest feature, which was responsibly disclosed to us. Please update. Material for MkDocs will continue receiving security updates through November 5, 2026. github.com/squidfunk/mk...
4 weeks after launching Zensical Studio, Markdown Preview is one of the most requested features – soon, you won't even need to leave the editor to get a truthful preview of your docs. Supports dark mode 🌗 If you haven't, check out Studio: zensical.org/studio/
If you missed it: Python Markdown has documented all of its extensions as being in maintenance mode. Good timing: we just rewrote Python Markdown in Rust, and it already powers Zensical Studio. It’s 10-20x faster and will be Open Sourced later this year. github.com/Python-Markd...
We announced our new Rust-based Python Markdown parser in yesterday's issue of Zensical Monthly: mail.zensical.org/monthly/2026...
Zensical Studio is out, and the bigger picture is coming together. We're building the next-generation Docs-as-Code stack, end to end, and we're right on track. More in tomorrow's newsletter. zensical.org/about/newsle...
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...
Now that Zensical Studio is out and humming, I'm picking up work on ZRX again, the heart of Zensical. Working hard on closing the remaining gap to MkDocs, so most projects can move to Zensical in the coming weeks/months ☺️ github.com/zensical/zrx...