A first note

Mon, 24 Aug 2026 00:00:00 GMT

This file is both a real post and the cheat sheet. Delete it once you've read it.

The block at the top, between the two --- lines, is the settings. The only two that are required are title and date — everything else is optional and just gets shown if it's there. If you want a cover photo, drop the image next to this file and add a line like cover: "./images/rain.jpg" up there, plus a coverAlt: "..." describing it.

Set draft: true and the post vanishes from the site, the feed, the email and Telegram until you set it back. That's how you park something half-finished.

Formatting, all of it

You already know most of this. Two asterisks make bold, one makes italic. A line starting with ## makes a heading like the one above. A line starting with > makes a pulled-out quote:

The tram stopped halfway up the hill and nobody seemed surprised.

A photo in the middle of the text is a line on its own that looks like this — the bit in the square brackets is the description for people who can't see it:

![Wet cobbles outside a closed bakery](./images/rain.jpg)

Three dashes on their own line make a divider, useful for a time jump:

And that's genuinely the whole vocabulary. Blank line between paragraphs, and don't worry about where your lines wrap in the editor — the site re-wraps them.

To publish: save the file, then git add ., git commit -m "lisbon", git push. About ninety seconds later it's live, the email has gone, and Telegram has it.

Notes

A first note

Formatting, all of it