Why
When scanning in “spots”, the gaze jumps between what stands out: links, bold, numbers (NN/g, 2019). A spot is visible against an even background. Each new highlight takes strength from the others, and after the third or fourth on a screen the reader stops trusting them: if everything is highlighted, nothing is the main thing.
What it looks like
Everything highlighted:
Before restoring, you must stop WordPress, otherwise it will write to the database, and the data gets mixed up. Backups are in /srv/backup/mariadb.
**Before restoring**, you **must stop WordPress**, otherwise it will
**write to the database**, and **the data gets mixed up**. Backups are in **/srv/backup/mariadb**.One spot:
Before restoring, stop WordPress: otherwise it writes to the database
mid-restore. Backups are in /srv/backup/mariadb.
Before restoring, stop WordPress: otherwise it writes to the database
mid-restore. Backups are in `/srv/backup/mariadb`.The path became code — it’s already set apart by the background and the monospace font. The warning comes first and without bold: the start of a sentence gets read anyway.
A bold start of a list item is a subheading
A list where every item starts with 2–5 bold words is a different case: there bold works as a small heading, not as emphasis. It’s the same on every item, sits in the same place in the line, and the eye scans it as the list’s table of contents — that’s how the pros and cons in this site’s overviews work.
Such a subheading rests on three conditions: every item has one, it’s short, and nothing else inside the items is bold. If only two items in five start in bold, or an item is a single line, it’s emphasis again and counts toward “one or two per screen”.
Other ways to highlight, and which to avoid
| Method | When |
|---|---|
| Bold | one or two spots per screen; a term at the moment it’s introduced |
| Code | commands, paths, config keys — set apart by itself and copyable |
| Italic | a word or two; not for long passages — in many fonts it reads worse at length, and in some scripts (Cyrillic, for one) it switches to handwritten forms |
| Underline | links only — underlined things on screen get clicked |
| CAPS | 1–2 word labels with letter spacing: “MAIN”, “THE MAIN CASE” |
| Color | links and meaningful labels; never the only signal — about 8% of men distinguish colors less well |
| A warning panel | one per page |