Writing a post

2026-10-20

Each post is a single Markdown file. The filename becomes the URL slug, so src/content/blog/writing-a-post.md is served at /posts/writing-a-post/.

Frontmatter

---
title: "Writing a post"
description: "One sentence, used for the meta description and the feed."
pubDate: 2026-10-20
updatedDate: 2026-10-21   # optional
draft: false              # optional, defaults to false
---

title and description are required strings; pubDate is parsed into a date, so an unquoted YAML date is fine. An entry with draft: true is excluded from the index, the routes, and the feed, but remains in the repository.

Inline elements

Text can carry bold, italic, inline code, and links. Code blocks are rendered with the language hint preserved:

npm run build
npx wrangler deploy

Images placed in public/ are referenced from the site root, and images placed beside a post can be imported by relative path if you later adopt Astro’s image pipeline.