Writing blog posts

Posts are Markdown files in content/blog/. The filename becomes the URL (my-post.md → /blog/my-post). This post documents the conventions — it's safe to delete once you (or your coding agent) know them.

Frontmatter

---
title: Required — the headline and the <title> tag
description: Strongly recommended — meta description, og:description, and the card teaser
date: 2026-06-05            # ISO date; posts sort newest-first
author: Jane Doe            # optional; shown in the byline + structured data
category: Guides            # optional; one per post, drives "related posts"
tags: [reference, howto]    # optional; rendered as #tags under the post
image: /img/posts/cover.png # optional; featured image + og:image
draft: true                 # optional; hides the post from the list
---

Drafts

Two levels, depending on how hidden a draft must be:

• draft: true hides the post from the blog list, but the URL still builds (anyone with the link can read it).
• A filename starting with _ (e.g. _work-in-progress.md) keeps the post out of the build, the sitemap, and prerendering entirely.

SEO — already handled

Each post automatically gets: title and meta description, Open Graph and Twitter tags, a canonical URL, JSON-LD BlogPosting structured data, prerendered HTML, and a sitemap entry. Your only jobs are a sharp title and an honest description of 150 characters or so.

Headings build the table of contents

Use ## and ### — they become the post's table of contents automatically. Start at ## (the post title is the only # on the page).