This is the obligatory first post. It exists to prove that a Markdown file in content/posts/ becomes an HTML page in _site/posts/. If you can read this in your browser, the pipeline works.

§1What lives in front matter

Title, date, categories, and an optional one-line summary. The generator infers everything else — the URL slug from the title, the reading time from the word count.

§2What lives in the body

Plain Markdown. Headings like the one above are renumbered automatically as §-sections by the build, so I never have to keep them in sync by hand. Code blocks render in Computer Modern Typewriter on a slightly darker paper:

content/posts/*.md  ->  generate.py  ->  _site/posts/*/index.html

That’s the whole story.