← All Essays

January 2026 · 3 min read

This Is an Example Essay

A demonstration of the Markdown-based essay system.

About Kwalia

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.

Written by

Javier del Puerto

Founder, Kwalia