Markdown and Readability

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:

Fenced blocks can use a language label
for syntax highlighting, or "text" for plain.

Horizontal rules separate big ideas:

More content follows. Full Markdown rendering means all of this—headings, lists, code, blockquotes—appears correctly on the blog page with minimal styling.