#sphinx
Tag

Why don't my markdown titles work sometimes?

Mar 14, 2025 3 minute read #markdown, #github, #obsidian, #hugo, #sphinx, #myst

I write a lot of markdown. I use it on GitHub when creating issues/PRs, I use it in Obsidian when I take notes, I use it in Hugo when writing blog posts (like this one), I use it in Jupyter Notebooks when working with data and I use it in Sphinx with MyST when writing documentation.
Debugging Sphinx extensions in VSCode

Jan 24, 2023 3 minute read #sphinx, #vscode, #debugging

This week I’ve been working on some custom Sphinx extensions for a documentation site.

Sphinx is a pretty complex tool with a broad ecosystem so documentation tends to be spread across the upstream project, dependencies like docutils and popular extensions like MyST. Therefore figuring out what is going on can be challenging, so I almost always resort to digging through state in a debugger and doing code spelunking on GitHub.

Why don't my markdown titles work sometimes?