Skip to content
Scrollback
Go back
How-To

Writing your first post

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.

FieldWhat it does
categoryPuts the post under a topic card on the home page
postTypeShows a coloured badge, such as How-To or Opinion
featuredPins the post to the Featured section on the home page
draftKeeps the post hidden until you set it to false
tagsFiner 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.


Share this post:

Previous Post
Welcome to Scrollback
Next Post
How topics, categories and tags fit together