Every post is a Markdown file in src/content/posts/. Create a new file, add a block of frontmatter at the top, and write below it.
Table of contents
Open Table of contents
The frontmatter
---
title: "Your post title"
description: "One or two sentences shown on cards and in search results"
pubDatetime: 2026-10-05T09:00:00Z
category: "Guides"
postType: "How-To"
featured: false
draft: false
tags:
- "writing"
---
Only title, description and pubDatetime are required. The rest are optional.
| Field | What it does |
|---|---|
category | Puts the post under a topic card on the home page |
postType | Shows a coloured badge, such as How-To or Opinion |
featured | Pins the post to the Featured section on the home page |
draft | Keeps the post hidden until you set it to false |
tags | Finer detail, used for tag pages and search |
Publishing
Commit and push. If your site is connected to Cloudflare Pages, Netlify or Vercel, it rebuilds on its own. Posts with a future pubDatetime stay hidden until that time.