Text and formatting

Paragraphs carry most of a page. Inline styles point out what matters inside them; headings let readers jump to the part they need.

Inline styles

Select text to format it:

• Bold for the words a reader must not miss, such as a button's name: click Publish.
• Italic for a term the first time you define it.
• Inline code for file names, settings and commands, like storage/logs.
• Highlight for a short phrase that should stand out on a skim.
• Underline sparingly: readers expect underlined text to be a link.
• Strikethrough for something that no longer applies, such as an old price.
• Links to another page or to a website.
• A tooltip explains a term without breaking the sentence.
• A formula inside a sentence, like a^2 + b^2 = c^2.

Headings

Headings build the page's outline and the "On this page" list beside it. Use them in order: a level three heading sits under a level two.

A level three heading

Groups a few paragraphs inside a section.

A level four heading

Rarely needed. If you reach for it often, the page may want splitting.