Writing Front Matter for Posts

Created on August 10, 2026 — updated on August 18, 2026

The contract

Only two fields are required for a file under docs/post/ to be picked up by the simple-blog-posts plugin:

---
title: My Post
date: 2024-06-03
---

category and tags are optional — they only affect whether the post shows up in the Blog Sidebar's Categories and Tags widgets.

What happens if title or date is missing

Nothing breaks. The file still builds as a normal page; it's just excluded from blog_posts, blog_categories, and blog_tags. This lets non-post files (an about.md, an index.md) live alongside real posts under the same directory without special-casing them.