Elektrine lite

← Feed

Martin Donath

squidfunk@fosstodon.org

<p>Founder of <span class="h-card" translate="no"><a href="https://fosstodon.org/@zensical" class="u-url mention">@<span>zensical</span></a></span>, creator of Material for MkDocs</p>

Posts

  • Post #4199167

    Sneak peek: Python Markdown snippets as first-class symbols in Zensical Studio. Rename a snippet – every inclusion site updates. Type-safe content reuse, finally. 🎯 ➑️ https://zensical.org/studio/

  • Post #4199166

    RE: https://fosstodon.org/@zensical/116839547124839290 Just shipped a massive new update for @zensical 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. https://zensical.org/studio/

  • Post #4199165

    Now that Zensical Studio is out and humming, I&amp;#39;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 ☺️ https://github.com/zensical/zrx/releases/tag/v0.0.25

  • Post #4199164

    RE: https://fosstodon.org/@zensical/116872571614501601 Zensical Studio is out, and the bigger picture is coming together. We&amp;#39;re building the next-generation Docs-as-Code stack, end to end, and we&amp;#39;re right on track. More in tomorrow&amp;#39;s newsletter. https://zensical.org/about/newsletter/

  • Post #4199163

    4 weeks after launching Zensical Studio, Markdown Preview is one of the most requested features – soon, you won&amp;#39;t even need to leave the editor to get a truthful preview of your docs. Supports dark mode πŸŒ— If you haven&amp;#39;t, check out Studio: https://zensical.org/studio/

  • Post #4199162

    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. https://github.com/squidfunk/mkdocs-material/releases/tag/9.7.7

  • Post #4199161

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

  • Post #4199160

    RE: https://fosstodon.org/@zensical/116958142916840063 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 ☺️

  • Post #4199159

    Edit a headline, save – 10 incoming links updated automatically. No need to remember updating them manually. That&amp;#39;s Zensical Studio – @zensical. Zensical Studio is in public beta and available here: https://zensical.org/studio/

  • Post #4199158

    πŸ‘€ 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: https://zensical.org/studio/

  • Post #4199157

    Codeberg now bans projects that mostly consist of AI-generated code. It&amp;#39;s not yet clear where the line between AI-assisted and AI-generated projects will be drawn, and how it will be enforced. https://www.youtube.com/watch?v=Y8cY1DEURtE

  • Post #3675421

    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. https://github.com/Python-Markdown/markdown/pull/1613

  • Post #3157361

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

  • Post #2938806

    We got some heat for warning our users that MkDocs 2.0 won&amp;#39;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. https://github.com/mkdocs/mkdocs/discussions/4088#discussioncomment-16917686

  • Post #2109352

    πŸ‘‹ Open Source maintainers: what&amp;#39;s your experience with issues and PRs sent to your repositories that are obviously fully LLM-generated?

  • Post #2109351

    RE: https://fosstodon.org/@squidfunk/116464706924183625 This is a prime example: LLM confidently hallucinating our recommended configuration, trapping the user into thinking it&amp;#39;s a bug. Stop submitting slop and wasting our time as maintainers! Always verify before you paste: https://github.com/squidfunk/mkdocs-material/issues/8584#issuecomment-4324498173

  • Post #2109349

    RE: https://fosstodon.org/@zensical/116493745343180648 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. πŸ˜…

  • Post #1640213

    ZRX 0.0.17 is out – the foundation of Zensical. This one&amp;#39;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: https://github.com/zensical/zrx/releases/tag/v0.0.17

  • Post #1640212

    RE: https://fosstodon.org/@zensical/116397062264202506 We&amp;#39;ve had plenty of requests for this – every issue of Zensical Monthly is now published online ☺️

  • Post #1640211

    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&amp;#39;s module system. Blog post: https://squidfunk.github.io/mkdocs-material/blog/2026/02/18/mkdocs-2.0/#why-forking-is-impractical ZAP 007 – Module system: https://zensical.org/spark/proposals/zap-007-module-system/

  • Post #1640209

    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&amp;#39;s at the core of everything we&amp;#39;re building with @zensical. https://www.youtube.com/watch?v=G1xqTjoihfo

  • Post #1640207

    Python Markdown Extension priorities – or – why you should probably never allow developers to pick their own magic numbers: What runs before or after what? 🀯

  • Post #1023510

    We just delivered the latest Zensical Monthly straight to the inbox of over 1,000 subscribers ☺️ https://zensical.org/about/newsletter/

  • Post #955979

    πŸŽ„ 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! πŸŽ„βœ¨ https://github.com/zensical/zensical/releases/tag/v0.0.15

  • Post #955974

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

  • Post #955971

    Making great progress on ZRX, the foundation for the module system that we&amp;#39;re cooking up for @zensical – it&amp;#39;ll offer several degrees of freedom, and allow for type-safe composition (= plugin interop) – something that MkDocs (now dead) never delivered. https://github.com/zensical/zrx/releases/tag/v0.0.10

  • Post #955970

    Adoption of @zensical is growing fast, as we&amp;#39;re already close to 100k monthly downloads! We&amp;#39;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 πŸš€ https://pypistats.org/packages/zensical

  • Post #955968

    Had our first open video call today! We demoed an early design draft of @zensical&amp;#39;s module system – the optimize plugin from Material for MkDocs (400 LOC) reduced to ~20 lines with ZRX modules. The runtime handles parallelization, caching &amp;amp; orchestration automatically.

  • Post #955967

    We just delivered Zensical Monthly, January 2026 edition straight to your inbox with the latest and greatest updates to keep you informed on what&amp;#39;s happening behind the scenes ☺️ We send 1 newsletter at the beginning of every month: https://zensical.org/about/newsletter/

  • Post #955966

    I will be on @talkpython next week, talking about @zensical ☺️ https://www.youtube.com/watch?v=V1BvvIPUzes