Skip to content

How to publish a post on this blog

The 60-second guide to adding content: one markdown file, one commit, done.

This post doubles as documentation for the kit's markdown blog, and as a live demonstration: you're reading it on a deployment of the kit itself. Every post here (including the articles around it) was published exactly this way.

Publishing in three steps

  1. Create content/blog/YYYY-MM-DD-your-slug.md.
  2. Start it with the front matter block:
---
title: "Your title"
description: "One sentence: it becomes the meta description and the index teaser."
date: 2026-02-01
author: Optional Name
---
  1. Write markdown below the second ---, commit, deploy. The post appears on /blog and in /sitemap.xml automatically, newest first.

Punctuation is not syntax

The front matter looks like YAML but is read as a flat list of key: value lines: everything after the first colon is the value. So a title can hold a colon, a #, an apostrophe or brackets without any quoting or escaping, and quoting it the YAML way works too. Only a line that is not a pair at all, a missing title or description, or a date nobody can read, is an error, and the message names the file.

SEO comes for free

Each post page sets the meta description, canonical URL and Open Graph article tags from the front matter. Write a real description for every post: that's the line searchers and social previews actually read.