Writing

Add an essay, a case study, or a documentation page.

Content lives in src/content/, one folder per collection. Each file is Markdown or MDX with a short block of frontmatter at the top.

Essays

Add a file to src/content/blog/. The file name becomes the URL.

---
title: On the pleasure of slow reading
description: A short case for reading fewer books, more carefully.
pubDate: 2026-03-02
tags: [reading]
---

Set draft: true to keep a post out of the production build while you work on it.

Posts can also take:

author — an id from src/content/authors.json. The post shows a byline and a short bio, and the author gets a page at /blog/author/<id>/.
series — any name. Posts that share it are listed together, oldest first, at the top of each one.

A table of contents appears when a post has three or more section headings. Reading time and related posts are set in src/config.ts under blog.

Case studies go in src/content/work/. They take a year and, optionally, a client and role, which are shown above the text.

Pages like this one go in src/content/docs/. The order field sets their position in the sidebar, lowest first.