2024-11-16

Why I use MkDocs to build my blog

I tried Jekyll first, but Ruby was not the toolchain I wanted to maintain for a technical note site. MkDocs felt closer to the Python and Markdown workflow I already use.

pip install mkdocs-material
mkdocs new my-blog
cd my-blog
mkdocs serve

It works well for math-heavy notes too:

$$ \frac{d x^*}{d \theta} = \left(I - \frac{\partial G}{\partial x}\right)^{-1} \frac{\partial G}{\partial \theta} $$