# Text and formatting

Headings, paragraphs and the inline styles that help readers scan.

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`.
- <mark>Highlight</mark> for a short phrase that should stand out on a skim.
- <u>Underline</u> sparingly: readers expect underlined text to be a link.
- ~~Strikethrough~~ for something that no longer applies, such as an old price.
- [Links](https://justdocs.qdev.tech/docs/writing/lists-and-quotes) to another page or to a website.
- A <Tooltip tip="Short explanations that appear on hover, so the sentence stays short.">tooltip</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.

<Tip>
Name a heading after what the reader will do or learn, such as "Connect your domain", rather than "Domains".
</Tip>