Hello, world

This is what an essay looks like on the site: a plain text file with a three-line block at the top for the title, date, and (optional) one-line summary shown on the homepage. Everything below the second --- is just markdown, which is basically text with two conventions:

  • A line starting with # becomes a heading. ## is a subheading.
  • Wrapping text in **stars** makes it bold; single stars make it italic.

That’s the whole thing. You don’t need any more markdown than that to write. Links look like [text](https://example.com) and lists start with a hyphen at the start of a line.

Adding a new essay

Copy this file, rename it to YYYY-MM-DD-your-slug.md, replace the front matter and body, commit, push. The site rebuilds automatically on GitHub and the new essay shows up at the top of the list.