Skip to content

Blog

Welcome to the moudrick.net blog!

Here you’ll find updates, notes, and technical explorations around my projects and ideas — evolving gradually over time.

Serving MkDocs in Codespaces: a simple workaround

If you are using MkDocs inside GitHub Codespaces, you may notice that the usual:

mkdocs serve

does not rebuild your site when Markdown files change. The internal watcher seems broken in Codespaces, and no amount of --dirtyreload or watchdog tricks reliably triggers a rebuild.

Here’s a simple, working workaround I use:


Step 1 — Add a Makefile

Create a Makefile in the root of your repo: