Writing in Markdown
Posts are written in Markdown: plain text with a little punctuation for formatting. You never have to use any of it — plain paragraphs are perfectly good posts — but here is the whole toolbox.
Emphasis and links
Wrap words in asterisks for italics or double asterisks for bold. Links look like this, written as [this](https://…).
Lists
Numbered steps:
- Write.
- Publish.
- Repeat.
Or bullet points:
- no ceremony
- no login required to read
- no lock-in
Quotes
Ease of use is the most underrated feature in publishing. If writing feels heavy, you stop writing.
Tables
| Format | Good for |
|---|---|
| Paragraphs | almost everything |
| Tables | comparisons and prices |
| Code blocks | anything technical |
Code
Inline code uses backticks, like site.config.json. Longer snippets get fenced blocks with a language name for highlighting-friendly markup:
export function greet(name) {
return `Hello, ${name}!`;
}
That is genuinely all of it. When in doubt, just write.