I'm really not looking for extra work as 2025 comes to an end, but I recently stumbled across mkdocs-quiz (https://ewels.github.io/mkdocs-quiz/) and it looks fantastic, so now I want to add interactive quizzes to every chapter of Git is my lab book (https://git-is-my-lab-book.net/) 😮‍💨 ...

#mkdocs #git #rse #training

MkSlides – Markdown to slides with a similar workflow to MkDocs

https://github.com/MartenBE/mkslides

#HackerNews #MkSlides #Markdown #Slides #MkDocs #Workflow #Presentation #Tools

Just released django-classy-doc v0.1.0! 🎉

New in this release: mkdocstrings handler for inline docs. Now you can embed CCBV-style class documentation directly in your MkDocs sites.

::: myapp.models.MyModel
handler: classydoc

> pip install django-classy-doc[mkdocs]

https://pypi.org/project/django-classy-doc/0.1.0/

#Django #MkDocs

@AstroHyde I used #eleventyjs on #GitHub pages, because #jekyll never sat well with me.

I am switching to #mkdocs this time, because I like #python better than #javascript

#Codeberg pages doesn't seem to have an opinion, as long as HTML is delivered to it.

ahhhhhhhhhhhhhhhhhhhhhh the more i make my wife's website in #mkdocs-material, the more i want to move my blog to this system.

seems way simpler than #hugo.

Started experimenting with #Zensical as a replacement for #mkdocs-material.It's blazing fast and has a nice new look.

Mein Projekt #kraft hat endlich eine neue Webseite bekommen: https://volle-kraft-voraus.de Schön mit #mkdocs...

One thing I've learned to love on the Fedi are content notes. Which means that my blog needs them, too!

Here's how I set up a macro in #MkDocs to make writing them easy, concise, and without repeating the same markup in every source file.

https://scy.name/blog/2025/11/mkdocs-content-notes.html

I can now add a content note to any blog post (or any page on the website really) simply by adding something like this to the Markdown source:

{{ cn("velociraptors", "electrified fences") }}

Anyway - if you have a #mkdocs #material site then give it a spin! It's super easy to use and helps add a little interactivity into your site. And did I mention that there's a confetti cannon? 🎊 Can't go wrong with confetti.

Bug reports / feature requests welcome!

So how did this come about?

We've been talking about having some multiple choice questions in the #nextflow training for a while. The website is built with the wonderful #mkdocs #material by @squidfunk

It came up again a few days ago, so I started poking around for plugins.

New open source package alert! 🔔 ewels.github.io/mkdocs-quiz/

A #MkDocs plugin to create interactive quizzes directly in your markdown:

<quiz>
What's the best static site generator?
- [x] mkdocs
- [ ] Jekyll
- [ ] Sphinx

You've come to the right place!

</quiz>

Heyyyyya,

Anyone using Obsidian and Mkdocs to publish their blog here?

#obsidian #mkdocs

Zensical – A modern static site generator built by the Material for MkDocs team

https://squidfunk.github.io/mkdocs-material/blog/2025/11/05/zensical/

#HackerNews #Zensical #MkDocs #StaticSiteGenerator #WebDevelopment #MaterialDesign

🌘 Zensical：由 Material for MkDocs 團隊打造的現代化靜態網站產生器
➤ 告別 MkDocs 的限制，擁抱更強大的文件網站生成新紀元
✤ https://squidfunk.github.io/mkdocs-material/blog/2025/11/05/zensical/
Material for MkDocs 團隊發布了 Zensical，這是一款全新的下一代靜態網站產生器。Zensical 汲取了十年的開發經驗，旨在克服 MkDocs 的技術限制，並提供更現代、更舒適的內容創作體驗。它從頭開始構建，支援 docs-as-code 工作流程，並能處理龐大的文件集，同時保持高性能和易用性。Zensical 確保了與 Material for MkDocs 的高度相容性，可直接讀取 mkdocs.yml 設定檔，用戶只需進行少量修改即可遷移。此專案採用 MIT 授權，完全開源，支援商業用途。為了提供專業支援，同時保持獨立性，團隊推出了 Zensical Spark 訂閱服務。
+ 太棒了！期待 Ze
#靜態網站產生器 #文件網站 #開源 #MkDocs

📦 I've released a new version of the RSS plugin for Mkdocs: https://github.com/Guts/mkdocs-rss-plugin/discussions/403

⚡ The good news is that it focuses on a significant performance improvement.

😬 The potentially bad news is that this comes at the cost of a major refactoring. So there might be some unpleasant surprises.

Happy testing!

#mkdocs #RSS

📦 J'ai publié une nouvelle version du plugin RSS pour Mkdocs : https://github.com/Guts/mkdocs-rss-plugin/discussions/403

⚡ La bonne nouvelle c'est qu'elle est focalisée sur une amélioration conséquente des performances.

😬 La potentiellement mauvaise, c'est que ça c'est au prix d'un gros refactoring. Donc il pourrait y avoir des mauvaises surprises.

Bons tests !

#mkdocs #RSS

Oh look, a new player in the static site generator space: The "Material for MkDocs" team is saying goodbye to the unmaintained MkDocs base and are instead writing a new, modern SSG from scratch, called Zensical.

https://squidfunk.github.io/mkdocs-material/blog/2025/11/05/zensical/

It doesn't have feature parity yet, but already looks quite capable. No blogging or custom plugins yet though, else I might've tried Zensical for the upcoming relaunch of my personal site.

#Zensical #SSG #WebDev #MkDocs

I’m sunsetting the Insiders program 🙂

I'm redirecting my time and energy from #MkDocs into #Zensical (see the announcement here: https://squidfunk.github.io/mkdocs-material/blog/2025/11/05/zensical/) @zensical

All currently private features will be released to the public this week.

Thank you so much to all my current and past sponsors! You are fantastic 💓

Only the Insiders program comes to an end ($$ -> access to private features): I will continue working on my open source projects, so you can keep sponsoring me if you like my work 😊

Yesterday my annoyance at not being able to see release number for codeberg repos in mkdocs documentation finally broke, combined with me understanding mkdocs enough.

So I'm delighted to announce the plugin mkdocs-material-codeberg-source-facts.

It still needs at least one polishing release to get most stuff right. However, that's a later todo.

Does somebody know a plugin for mkdocs for issue links?

I want to write a link to an issue, e.g. [!ISSUE!](https://codeberg.org/rimu/pyfedi/issues/1420), and displays a nice button with say "repo name + STATUS".

Thanks! I need it to track all the complaints, issues, I open in Fediverse repositories.