Field note

Building this place

Why this site starts with Markdown, a small stylesheet, and Soupault.

2 min read

I wanted a place to write that felt closer to a folder of documents than a software product. Something fast, legible, and easy to understand after I have ignored it for six months.

Markdown is the source

Each post is a Markdown document. Soupault renders it to HTML, extracts the title, date, and first paragraph with CSS selectors, then uses that information to build the index.

The source stays readable before and after the build.

A boring build is a feature

The development server downloads one pinned Soupault binary, rebuilds when a source file changes, and serves the result locally. Production runs the exact same build script. That keeps the distance between editing and publishing pleasantly short.

This first post is also a fixture: a real page that exercises Markdown rendering, typography, metadata extraction, clean URLs, and the generated post list. From here, adding a post is just adding a file.