LaunchCrate

← All posts

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 strikethrough in 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.