Frontmatter reference

Frontmatter is the YAML block between --- lines at the top of every article.

---
title: Building Romyq
description: Why I built an autonomous project manager.
date: 2026-07-12
updated: 2026-07-15
tags:
  - rust
  - ai
  - productivity
published: true
cover: ./images/cover.webp
---

Fields

Field Required What it does
title yes Article title. Shown on the page, cards, feeds, and <title>.
description yes One-or-two-sentence summary. Used on cards, meta description, OpenGraph, and search results.
date yes Publication date (YYYY-MM-DD). Controls ordering everywhere. A future date keeps the article hidden until that day.
updated no Last-revision date. Shown next to the publish date and used in JSON-LD / sitemap.
tags no List of plain strings. Each tag automatically gets a page at /tags/<tag>/.
published no Defaults to true. Set false and the article is never built — it appears nowhere on the production site.
cover no Path to a cover image relative to the article, e.g. ./images/cover.webp. Shown on the article, on cards, and used as the OpenGraph image.

Rules worth remembering