adding blog posts

blog posts work differently from handbook/docs pages. they use plain markdown (not MDX) and have additional frontmatter for display on the blog listing.

creating a blog post

1. create a .md file in content/blog/
2. the filename becomes the URL slug: my-post.md → /blog/my-post

frontmatter

---
title: "your post title"
date: "January 2026"
image: "/your-image.jpg"
size: "large"
---

fields

• title (required) - displayed on the listing and post page
• date (required) - publication date, displayed on listing
• image (required) - path to hero image in public/ folder
• size (required) - card size on the blog listing page:
  • large - full width, prominent placement
  • medium - half width
  • small - quarter width

images

1. add your image to the public/ folder
2. name it descriptively: blog-your-post-name.jpg
3. reference it in frontmatter as /blog-your-post-name.jpg

recommended image dimensions vary by size - larger cards need higher resolution images.

writing content

write standard markdown below the frontmatter:

---
title: "my post"
date: "January 2026"
image: "/blog-my-post.jpg"
size: "medium"
---

your introduction paragraph here.

## a subheading

more content with **bold** and *italic* text.

- bullet points
- work too

differences from handbook/docs