Advertisement · 728 × 90

Posts by Zensical

We just released the module system, so we can now start tackling T1 and T2 plugin support, including the blog plugin from Material for MkDocs.

3 days ago 1 0 1 0
Preview
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...

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

3 days ago 3 2 1 0
Video

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

1 week ago 6 2 0 0
Preview
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...

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

2 weeks ago 3 4 0 0
Post image

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

2 weeks ago 4 1 1 0
Post image

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

4 weeks ago 5 2 0 0
Preview
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...

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

1 month ago 5 2 0 0
Advertisement

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.

1 month ago 1 1 0 0
Zensical - a modern static site generator - Talk Python live stream
Zensical - a modern static site generator - Talk Python live stream YouTube video by Talk Python

I will be on @talkpython.fm next week, talking about @zensical.org ☺️

www.youtube.com/watch?v=V1Bv...

2 months ago 3 1 0 0

Thanks for the heads up! We just verified that the newsletter registration works – an email is sent out for confirmation, and the confirmation link works as expected. If you're sure that the email address entered is valid, please reach out to members@zensical.org, so we can check what went wrong.

2 months ago 1 0 0 0
Post image

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

2 months ago 4 1 0 0
Post image

Had our first open video call today! We demoed an early design draft of @zensical.org's module system – the optimize plugin from Material for MkDocs (400 LOC) reduced to ~20 lines with ZRX modules.

The runtime handles parallelization, caching & orchestration automatically.

2 months ago 6 1 1 0
Post image

Adoption of @zensical.org is growing fast, as we're already close to 100k monthly downloads!

We're working hard on reaching feature parity within the coming months, so all Material for MkDocs users can switch to a maintained, modern docs stack 🚀

pypistats.org/packages/zen...

2 months ago 5 2 2 0
Preview
Release 0.0.19 · zensical/zensical This version adds support for the generation of objects.inv for your mkdocstrings-powered documentation site, allowing external tools to discover and link to your API documentation. No changes to y...

Zensical 0.0.19 ships generation of objects.inv for mkdocstrings-powered documentation sites!

github.com/zensical/zen...

2 months ago 3 1 0 0
Advertisement
Preview
Release 0.0.10 · zensical/zrx Summary This version includes a large refactoring of Iterator impls across various Store decorators, enhancing code clarity and maintainability. Additionally, almost all impl Iterator return-positi...

Making great progress on ZRX, the foundation for the module system that we're cooking up for @zensical.org – it'll offer several degrees of freedom, and allow for type-safe composition (= plugin interop) – something that MkDocs (now dead) never delivered.

github.com/zensical/zrx...

2 months ago 2 2 0 0
Preview
Release 0.0.17 · zensical/zensical Summary This version brings support for automatic and manual API cross-references. Symbol names on pages that include auto-generated API documentation now automatically link to the relevant section...

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.

github.com/zensical/zen...

2 months ago 3 2 0 0

MkDocs hasn't had a plugin system for the first three years. We're working very hard to deliver a battle-tested module system for @zensical.org this summer, at latest.

3 months ago 4 1 0 0
Preview
Release 0.0.7 · zensical/zrx Summary This version improves performance of selector matching by up to a factor of 1,000, especially when many components are empty, which is the norm. Additionally, it includes several breaking c...

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.

github.com/zensical/zrx...

3 months ago 3 1 0 0
Preview
Zensical Adaptive systems for evolving ideas – Zensical creates scalable Open Source systems for technical writing that always keep you in the flow

📮 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:
zensical.org/about/newsle...

3 months ago 3 1 0 0
Preview
Zensical Adaptive systems for evolving ideas – Zensical creates scalable Open Source systems for technical writing that always keep you in the flow

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.org/about/roadmap/

3 months ago 6 1 0 1

Migrating to Zensical from Material for MkDocs is simple 🚀

3 months ago 2 0 0 0
Advertisement
Video

🎄 Merry Christmas 🎅

Zensical 0.0.15 brings fuzzy search support, and improves tooltip behavior on touch devices. The Zensical team wishes you a joyful holiday season and a fantastic new year! 🎄✨

github.com/zensical/zen...

3 months ago 1 1 0 0
Post image

We'll soon ship support for fat fingers – aka fuzzy search.

Fuzzy search is particularly tricky to get right, since enabling it generally deteriorates exact or prefix matches quite significantly. Disco only uses it as a fallback, combining it with other matched terms. No special syntax necessary.

3 months ago 2 1 0 0
Post image

⚠️ Warning

We’ve been made aware of a crypto coin falsely using the name “Zensical.” To be clear: this is a scam, unauthorized, and not affiliated with us in any way.

Please avoid and report.

3 months ago 1 2 0 0
Preview
Release 0.0.13 · zensical/zensical Summary This release updates the user interface to v0.0.2, which includes various improvements and bug fixes, and ships 132 new icons. It might be a breaking change, as Simple icons removed 37 icon...

Zensical 0.0.13 is out – our second release today.

This release fixes all known issues in the user interface, which means we'll now focus again on the runtime, so we can start working on the module system very soon.

github.com/zensical/zen...

3 months ago 4 1 0 0
Preview
Release 0.0.12 · zensical/zensical Summary This release fixes several issue with mkdocs.yml parsing, problems with zensical new, and other bugs. It's also the first release that goes through our new release workflow powered by mono,...

Zensical 0.0.12 is out!

github.com/zensical/zen...

3 months ago 1 2 0 0

The primary motivation behind mono is to unify how we work with monorepos at Zensical. Since we manage monorepos in Rust and TypeScript, those are the first supported ecosystems. Scopes are package-bound, making daily work and releases smooth and predictable.

3 months ago 2 0 0 0
GitHub - zensical/mono: Mono repository automation toolkit Mono repository automation toolkit. Contribute to zensical/mono development by creating an account on GitHub.

We've just released mono, our new mono repository automation toolkit:

- Supports Rust and NPM projects
- Automatic scope detection
- Interactive version bumps
- Beautiful changelogs
- Standalone executable

github.com/zensical/mono

3 months ago 2 0 1 1
Advertisement
Post image

📣 mkdocstrings is now supported in Zensical!

We just shipped Zensical 0.0.11 with initial mkdocstrings support. Features like cross-refs and backlinks are still in progress, but API docs already look great with Zensical.

Give it a spin:
zensical.org/docs/setup/e...

4 months ago 7 2 0 0
Video

New pricing page for @zensical.org is live.

Using instant previews to surface additional context without disrupting the reading flow – they can be quite effective for progressive disclosure.

Documentation for instant previews:
zensical.org/docs/setup/n...

4 months ago 3 1 0 0