Markdown typography sample

This post exists to exercise the Markdown styles used across the site. It includes common writing elements, code, and a few edge cases.

Text

Plain paragraphs should stay readable at the site width. Links such as Astro should feel part of the text, while inline code should stand out without becoming too loud.

Use bold text for emphasis, italic text for tone, and strikethrough when something is obsolete.

Lists

  • Unordered item
  • Another unordered item
    • Nested unordered item
    • Another nested item
  1. First ordered item
  2. Second ordered item
  3. Third ordered item

Quote

Good typography should make the structure obvious before the reader thinks about the styling.

Code

Inline commands like bun run build should be easy to scan.

type ThemePreference = "system" | "light" | "dark";

function resolveTheme(
  preference: ThemePreference,
  systemTheme: "light" | "dark",
) {
  return preference === "system" ? systemTheme : preference;
}
bun install --frozen-lockfile
bun run build

Table

PreferenceStored valueBehavior
SystemsystemFollows the OS theme
LightlightForces the light theme
DarkdarkForces the dark theme

That should cover the elements most posts are likely to use.