How to publish an essay


This post exists mainly as a note to myself. To publish a new essay, add a Markdown file to src/content/blog/. The file name becomes the URL slug, so the-cost-of-abstraction.md publishes at /blog/the-cost-of-abstraction/.

Every post needs a small block of frontmatter at the top:

---
title: 'The cost of abstraction'
description: 'One sentence that shows up in previews and the RSS feed.'
pubDate: 'Aug 12 2026'
heroImage: '../../assets/blog-placeholder-4.jpg'
---

Your writing starts here...

Only title, description, and pubDate are required. heroImage is optional — drop an image into src/assets/ and point to it. You can also add updatedDate if you revise a piece later.

Everything below the frontmatter is standard Markdown: headings, links, lists, images, and fenced code blocks with syntax highlighting. If you want React or interactive components inside a post, rename the file to .mdx and import them directly.

To preview locally, run npm run dev and open the printed URL. When it looks right, commit and push — the live site rebuilds automatically.