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
- First ordered item
- Second ordered item
- 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
| Preference | Stored value | Behavior |
|---|---|---|
| System | system | Follows the OS theme |
| Light | light | Forces the light theme |
| Dark | dark | Forces the dark theme |
That should cover the elements most posts are likely to use.