← Field notes
May 2, 20261 min readRex

Adding a post to this blog (and why it's just a file)

How new Field Notes get published — a single markdown file with a short header block, no dashboard, no database, no login.

This blog has no CMS. Every post is a markdown file in src/content/blog/, and the site picks it up automatically the moment the file exists.

The shape of a post

Each file starts with a small header block, then the body:

---
title: Your headline here
description: One or two sentences. This becomes the search and social preview.
date: 2026-05-02
author: Rex
tags: Operations, Audit
---

Body text in markdown.

The filename becomes the URL. where-your-week-leaks.md is published at /blog/where-your-week-leaks.

What happens automatically

  • The post appears on the Field Notes index, newest first, sorted by date.
  • Reading time is calculated from the word count.
  • Page title, meta description, canonical link, and Open Graph tags are generated from the header block.
  • Structured data — a BlogPosting schema block — is emitted on the post page, and a Blog schema listing every post is emitted on the index. That's the part search engines read to understand the article, its author, and its publish date.

What you write

Standard markdown: headings, lists, bold, links, and blockquotes all render with the site's typography.

Keep them short and specific. A note that names a number is worth ten that describe a category.

No build step to remember, no publish button to find. Add the file, and it's a page.

Want this run for you?

The Operations Audit maps where your week leaks time and money — and if we can't find 10 recoverable hours a month, you don't pay for it.

Book your Operations Audit