Founder of @zensical, creator of Material for MkDocs
Joined December 2011
- Tweets 4,587
- Following 212
- Followers 4,244
- Likes 4,010
796 Photos and videos
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/zensical…
1
4
185
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/zensical…
2
9
945
May 14
We got some heat for warning our users that MkDocs 2.0 won't have a plugin system in Material for MkDocs.
The maintainer just confirmed it again and is actively working on MkDocs 2.0 – no plugins, by design. Markdown templating only.
github.com/mkdocs/mkdocs/dis…
2
9
824
May 6
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/20…
1
4
8
776
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/zensical…
1
2
10
641
Zensical 0.0.39 is out – a bugfix release smoothing out edges on link validation and the new lightbox integration.
github.com/zensical/zensical…
1
4
455
Apr 30
Pretty happy with how this turned out! We found so many issues in our own docs when dogfooding – unresolved links and unused definitions that had been silently hiding for months. 😅
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/zensical…
3
1
8
501
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/zensical…
1
8
584
Apr 27
This is a prime example: LLM confidently hallucinating our recommended configuration, trapping the user into thinking it's a bug. Stop submitting slop and wasting our time as maintainers! Always verify before you paste:
github.com/squidfunk/mkdocs-…
Apr 25
👋 Open Source maintainers: what's your experience with issues and PRs sent to your repositories that are obviously fully LLM-generated?
3
2
4
536
Apr 25
👋 Open Source maintainers: what's your experience with issues and PRs sent to your repositories that are obviously fully LLM-generated?
25%
👍 Fine if high quality
25%
👎 Slop, waste of my time
6%
😐 Depends on the case
44%
🍿 Show results
16 votes • Final results
6
4
2,615
Apr 24
Python Markdown Extension priorities – or – why you should probably never allow developers to pick their own magic numbers:
What runs before or after what? 🤯
5
462
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/zensical…
1
1
3
351
Apr 16
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.
youtube.com/watch?v=G1xqTjoi…
1
2
563
Apr 14
We updated our blog article with a detailed explanation on why we believe forking MkDocs is not a viable path forward. We borrowed parts of ZAP 007, our latest proposal on the requirements identified for Zensical's module system
zensical.org/spark/proposals…
squidfunk.github.io/mkdocs-m…
1
1
9
807
Apr 13
We've had plenty of requests for this – every issue of Zensical Monthly is now published online ☺️
All issues of Zensical Monthly are now public. Catch up on anything you missed, or share an issue with your team:
zensical.org/about/newslette…
1
9
557
Apr 7
We just delivered the latest Zensical Monthly straight to the inbox of over 1,000 subscribers ☺️
zensical.org/about/newslette…
9
431
Apr 7
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/rele…
3
1
16
1,179
Apr 7
If you're wondering about the phases, here's our phased transition strategy enabling you to move over your MkDocs projects to Zensical:
zensical.org/compatibility/#…
2
196