
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.