How to add a note (read me, then delete me)

This post is a cheat sheet for future-you. Once you’ve read it, delete this file.

To publish a new note

  1. Go to the src/content/blog/ folder.
  2. Duplicate any existing .md file and rename it (the file name becomes the URL, so use lowercase words with hyphens, like carbon-markets-are-weird.md).
  3. Edit the bit at the top between the --- lines. Only three fields matter:
    • title: the headline
    • description: one sentence, shows up in the list
    • pubDate: the date, like 'Aug 15 2026'
  4. Write the body below the second --- in plain text. Blank lines separate paragraphs. ## Like this makes a subheading.
  5. Save. If you’re using GitHub’s website, that’s a “commit.” Your site rebuilds and the note is live in a minute or two.

That’s the whole workflow. No plugins, nothing to break.

Optional: add a header image

Put an image in src/assets/, then add a line to the top block:

heroImage: '../../assets/your-image.jpg'

That’s it.