This is an example blog post. It lives in src/content/blog/, which means Astro can validate the frontmatter, generate a page for it, include it on the blog index, and add it to the RSS feed.

The basic workflow

Create a new Markdown file in src/content/blog/ with a lowercase, hyphenated filename. The filename becomes the URL slug.

For example:

src/content/blog/my-new-post.md

becomes:

/blog/my-new-post/

Required frontmatter

Each post needs this frontmatter at the top:

---
title: "My New Post Title"
description: "A 70 to 200 character summary used for SEO, previews, and the RSS feed."
publishDate: 2026-04-30T12:00:00-05:00
tags:
  - AI systems
  - Automation
---

After the frontmatter, write the post in normal Markdown: headings, paragraphs, lists, links, code blocks, and quotes all work.

Publishing

After adding or editing posts, run:

npm run build
npm run deploy

The build step checks that the post metadata matches the site schema before anything goes live.