Adding a post to this blog is just dropping a Markdown file into the _posts/ folder. No HTML required.

File naming

Name each file with the date first, then the title:

_posts/2026-08-23-how-this-blog-works.md

The date in the filename controls the publish date and the post’s position in the list, and newer posts appear at the top automatically.

Front matter

Every post starts with a small YAML block between two lines of ---. Only the title is required:

---
title: "My post title"
---

You can also override the date here if you want, e.g. date: 2026-08-23 14:30.

Writing

Everything below the front matter is plain Markdown — headings, lists, code blocks, tables, links, and images all work. Images go in the images/ folder and can be referenced like this:

That’s it — commit the file, push, and it shows up on the blog page.