January 2026 · 3 min read
This Is an Example Essay
A demonstration of the Markdown-based essay system.
This is the first paragraph of the essay. It will get the special drop-cap styling automatically. You can write naturally in Markdown and the build script converts it to HTML.
How It Works
The system is simple. You write essays in Markdown files with YAML frontmatter at the top. The frontmatter contains metadata like the title, date, tags, and related essays. The body is regular Markdown.
When you run `python3 build_essays.py`, it:
1. Reads all `.md` files from `content/essays/` 2. Parses the YAML frontmatter 3. Converts Markdown to HTML 4. Injects the content into the template 5. Writes the output to `essays/`
Formatting Examples
You can use bold text and italic text. You can also create links to other pages which automatically open in new tabs for external URLs.
Blockquotes work too. They get styled with the pink left border.
Internal links like this essay about cyborgs don't get the external link treatment.
Why This Matters
Instead of editing 400+ lines of HTML for each essay, you write ~50 lines of Markdown. Style changes happen in one template file. Metadata lives in frontmatter, not scattered across HTML.
This makes it easier for anyone—human or AI—to add and update essays.