Blog

Markdown stays readable as plain text while still rendering nicely on the web. That’s why it’s a good default for blog posts and docs.

Structure

Use headings to break up the page:

• H2 for main sections
• H3 for subsections
• Short paragraphs and lists for the rest

Lists don’t need to be long. Sometimes three items are enough:

1. One idea per bullet.
2. Keep sentences short.
3. Prefer clarity over cleverness.

Code and emphasis

Use italics for emphasis and bold when you need it. For code, prefer `backticks` inline and fenced blocks for snippets:

A static site is just HTML, CSS, and maybe a little JavaScript. No database, no server-side runtime—just files.

Why static?

• Fast. Every page is a file. No queries, no rendering on request.
• Simple. Deploy anywhere: any host, CDN, or object storage.
• Stable. Fewer moving parts, fewer things to break.

A minimal stack

1. Write content in Markdown.
2. Run a generator (e.g. Hugo) to produce HTML.
3. Upload the output folder. Done.

Inline code and fenced blocks work as expected: