blog

How to add a new post

This post is a reference for future-you. Once you're comfortable, delete the file content/blog/how-to-add-a-post.md and it disappears.

Add a post

  1. Create a new file in content/blog/, e.g. my-first-idea.md.
  2. Start it with frontmatter — the block between the --- lines:
---
title: "My first idea"
date: "2026-06-01"
summary: "One sentence shown in the blog list."
image: "/assets/my-first-idea.jpg"
---

The image line is optional — add it to show a header image on the post (put the file in public/assets/). Leave it out for a text-only post.

  1. Write the post below the frontmatter in plain Markdown.
  2. Save, commit, and push. The site rebuilds and the post is live.

What you can write

Markdown gives you headings, bold, italic, links, lists, inline code, code blocks, and quotes. The filename (without .md) becomes the URL — so this post lives at /blog/how-to-add-a-post.

That's the whole workflow.