Writing posts for this blog
Each post is a Markdown file in api/content/blog/. The file name is the
URL: writing-posts.md is served at /blog/writing-posts.
Front matter
Every file starts with a short header:
---
title: Writing posts for this blog
date: 2026-10-04
summary: Shown on the index, in the RSS feed, and in link previews.
author: Optional byline
draft: true
---
author and draft are optional, and a post with draft: true isn't
published. There are no comments in front matter: everything after the
colon is the value, so draft: true # note doesn't make a draft.
A missing title, date, or summary — or any key the blog doesn't know — stops the server at startup with the file name, and fails CI, so a broken post never reaches visitors.
What you get
- Server-rendered pages with titles, descriptions, canonical URLs, and Open Graph tags, so search engines and link previews see real content.
- An RSS feed at
/blog/rss.xml, and every post in/sitemap.xml. - Tables, footnotes, and
strikethroughin addition to standard Markdown.
Raw HTML in a post is shown as text rather than rendered: a pasted
<script> tag can never run on your site.