Typography
Headings, paragraphs, emphasis, blockquotes, links, dividers, and footnotes — every text primitive at a glance.
A reference for every text-level element the renderer supports. Use it as a styleguide when writing or reviewing docs.
Headings
The page title above is rendered from front-matter as an h1. Use ## for top-level sections and ### for the subsections inside them. Going deeper than ### is generally a sign the page should be split.
This is a third-level heading
It sits inside a second-level section and shows how subheadings sit visually under their parent.
Another third-level heading
The right-rail table of contents picks up h2 and h3 only — h4 and deeper are deliberately ignored so the TOC stays scannable.
Paragraphs and inline emphasis
A plain paragraph is just a line of prose, wrapping naturally and breathing at a comfortable line height. You can mix in bold for strong emphasis, italic for softer stress, both together for the rare case where you really mean it, and strikethrough for deletions or corrections.
Inline code spans highlight technical tokens like file names, variable names, or short snippets without breaking the line. Combine them with bold inline code when a token is also the subject of the sentence.
Links
Links come in two flavours. The basic inline link to the quickstart sits naturally in a sentence. You can also link to an external site like the Anthropic homepage — external links should open in a new tab in the rendered output.
Reference-style links work too. You can use a reference link when the same destination appears multiple times in a page, and the URL definition lives at the bottom.
Blockquotes
A blockquote sets prose apart from the surrounding text. It works well for pull quotes, customer testimonials, or excerpts from longer documents.
Blockquotes can span multiple paragraphs.
A blank line between quoted lines starts a new paragraph inside the same quote — useful for longer excerpts where the original had paragraph breaks.
Quotes can also be nested for replies-to-replies, though it gets cluttered fast.
Like this. One level deep is usually enough.
Horizontal rules
Three or more dashes on a line of their own become a horizontal rule. Use them to break a long page into distinct sections when headings would be too heavy.
Like that.
Footnotes
Footnotes are useful for citations or asides that would clutter the main flow.1 The reference becomes a superscript link, and the note itself lives at the bottom of the page.2