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.

Zensical@zensical.org · 6d ago

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

Came across this beautiful Zensical mod ☺️ linguistik.hispanistica.com

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

Codeberg, are you serious?!?

YouTube video by Theo - t3․gg

youtube.com

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

Zensical@zensical.org · 2w ago

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/

Python Markdown is too strict about link labels. We're working on fixing that in Zensical's new Rust-based Markdown implementation ☺️ No more [`module.symbol`][module.symbol] workarounds.

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

Release mkdocs-material-9.7.7 · squidfunk/mkdocs-material

Warning Material for MkDocs is approaching end of life Material for MkDocs is scheduled to reach end of life on November 5, 2026. Until then, maintenance is limited to critical bug fixes and securi...

github.com

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

Document all extensions are in maintenance mode by waylan · Pull Request #1613 · Python-Markdown/markdown

This has been the de facto policy for some time. We are now officially documenting it. Relates to #1612. Some recommendations for alternative extensions have been included. If anyone would like to ...

github.com

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

Zensical@zensical.org · last mo.

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

Release 0.0.25 · zensical/zrx

Summary This version adds Sequence as the ordered relation layer on top of Expression, which is what makes route matching work for keyed relations like page -> tags. With Sequence, those relations ...

github.com

Just shipped a massive new update for @zensical.org Studio! We’re pushing hard on docs-as-code: workspace intelligence for Markdown, transitive snippet awareness, anchor/link refactors, and much better navigation. Still early, but this is the direction. zensical.org/studio/

Zensical

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

zensical.org

Zensical@zensical.org · last mo.

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

Writing tests for our new Python Markdown TextMate grammar that we shipped as part of Zensical Studio - so much fun 😎 github.com/zensical/stu...

Very proud of the team today: we’re launching Zensical Studio. 👏 A lot of work went into making this fast, precise, and useful in real documentation projects. If you write docs with @zensical.org or MkDocs, we'd love your feedback!

Zensical@zensical.org · 2mo ago

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/

Writing Rust in Zed – boy, can it get any better than that?

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

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/mkdoc...

[RfC] Who should maintain mkdocs? · mkdocs mkdocs · Discussion #4088

ImportantNothing in this post is official. It's a simple Request for Comment to see what the communities overall opinion is about MkDocs current maintainership, and if there should be a change. It ...

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

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@zensical.org · 3mo ago

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