How to Publish an Article
Adding a Markdown file to content/blog/ publishes a new post. Here's the full recipe, including front matter.
Publishing to this blog takes one step: add a Markdown file to content/blog/. The filename
becomes the URL slug, so content/blog/my-first-post.md is served at /blog/my-first-post.
Front matter
Start each file with a YAML front-matter block between --- fences:
---
title: "Your headline"
date: 2026-08-05
author: "Your name"
excerpt: "One or two sentences shown on the index page and in link previews."
---
Your article body goes here, written in **Markdown**.
All fields are optional and sensibly defaulted:
| Field | Default if omitted |
|---|---|
title |
A title-cased version of the filename |
date |
The file's last-modified time |
author |
Hidden |
excerpt |
The first ~200 characters of the body |
draft |
false — set to true to keep a post unpublished |
Writing the body
The body supports GitHub-Flavored Markdown: headings, bold, italics, lists, tables, links, block quotes, and fenced code blocks with syntax like the example above. Raw HTML is escaped for safety.
Publishing
Commit the file and deploy. That's it — the article appears on /blog, newest first, and reading
time is estimated automatically. To unpublish, delete the file or set draft: true.