How to write posts on this blog
A post is one .md file in src/content/posts/. The filename becomes the URL:
writing-posts.md → /posts/writing-posts.
Frontmatter
A block between --- at the top of the file:
---
title: Post title # required
date: 2026-08-08 # required
description: One-line summary # optional, used in lists and RSS
tags: [astro, notes] # optional
draft: true # optional
---The fields are schema-checked at build time. Forget one or get a type wrong and
npm run build fails with a clear message instead of shipping a broken page.
Drafts
draft: true keeps a post visible under npm run dev but out of the build and out of RSS.
Handy for writing across several sittings without hiding the file from the repository.
The rest
The body is ordinary markdown: headings, lists, tables, quotes, syntax-highlighted code. Put
images in public/ and reference them as .