Keep Heading Levels Shallow and Descriptive
Limit heading depth to h1–h3 in most contexts. Deeper levels (h4–h6) often indicate content that should be restructured. Write descriptive, skimmable headings that tell the reader what the section contains, not generic labels.
Avoid all-italic headings; they feel weak at heading sizes.
Incorrect (deep nesting, generic headings):
<h1>Documentation</h1>
<h2>Getting Started</h2>
<h3>Prerequisites</h3>
<h4>System Requirements</h4>
<h5>Minimum Specifications</h5> <!-- too deep -->
<h6>Processor</h6> <!-- way too deep -->Correct (shallow, descriptive headings):
<h1>Documentation</h1>
<h2>Install on macOS, Linux, or Windows</h2>
<h3>System requirements</h3>
<!-- Restructure deeper content as lists or prose -->Use text-transform: uppercase or text-transform: capitalize in CSS rather than typing headings in all caps in the HTML.