By Joe  ·  April 7, 2026  ·  Tutorial  ·  ~6 min read Also published at info.manitec.pw/blog/mkdocs-snippets Here’s a fun way to waste an afternoon: build an automated system that generates markdown files in CI, include them in your docs with pymdownx.snippets, deploy successfully, and then discover that every single page is completely blank where your content should be. No errors. No warnings. Just… ...

April 6, 2026 · Joe · Dev Log + Tutorial · ~8 min read Also published at info.manitec.pw/blog/docs-fixes There’s a certain kind of programmer satisfaction that comes not from building something shiny, but from systematically destroying and then resurrecting your own infrastructure in a single sitting. Today was that day. My docs site — info.manitec.pw — is built with MkDocs Material and deployed to GitHub Pages via a CI workflow. It’s been “working” ...