Markdown & MDX style guide

This post exists so you can see how each Markdown element renders with the blog’s prose styles. Use it as a visual reference, then delete it.

Headings

The document title above is an <h1>. Use ## for section headings and ### for subsections.

A subsection

Body text wraps naturally and stays readable at a comfortable measure.

Text formatting

You can write bold text, italic text, and inline code. You can also link to another page — links use the brand color.

Lists

An unordered list:

• First item
• Second item
• Third item, a little longer to show wrapping

An ordered list:

1. Research the topic
2. Draft the outline
3. Write, edit, ship

Blockquote

Design is not just what it looks like and feels like. Design is how it works.

Code block

export function readingTime(text: string): number {
	const words = text.trim().split(/\s+/).length;
	return Math.max(1, Math.round(words / 200));
}

Table

Element	Syntax	Renders as
Bold	**text**	text
Italic	_text_	text
Code	`code`	code

That’s the full set. Everything here is styled by .prose in src/styles/global.css.