Writing posts

Add a blog post

Create src/content/blog/my-post.md:

---
title: "My post"
description: "One-line summary for the index page and RSS."
date: 2026-09-10
tags: ["rl", "evals"]
draft: false
---

Body goes here.

The filename becomes the URL: my-post.md → /blog/my-post/.

Add a docs page

Same thing under src/content/docs/, with order instead of date and tags:

---
title: "Page title"
description: "Optional subtitle."
order: 2
---

Frontmatter reference

Field	Blog	Docs	Notes
title	required	required
description	optional	optional	Used in <meta>, index, RSS
date	required	—	Any parseable date string
updated	optional	—	Shown next to the date
tags	optional	—	Array of strings
order	—	optional	Sort key, defaults to 100
draft	optional	optional	true hides it from the build

Local development

npm install
npm run dev     # http://localhost:4321
npm run build   # outputs to dist/

Push to main and Vercel deploys automatically. Pull requests get their own preview URL.