How this blog works

This blog is built so that dropping in a Markdown file is all it takes to publish a post. I’m leaving the how-to here as a note to my future self.

Adding a post

Create one .md file in src/content/blog/. The file name becomes the URL (this post lives at /blog/how-this-blog-works/).

Start the file with these three lines:

---
title: Post title
date: 2026-07-04
---

Body starts here.

The rest is plain Markdown. Headings are ##, lists are -, quotes are >.

Adding images

Images go through a small bundled script first (which strips location data and other shooting metadata). Then reference them like this:

![description](/note/images/filename.png)

Publishing

Push to GitHub, and the site updates itself a few dozen seconds later. That’s all.

← Index