A first note
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:
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.