heading-skips-a-level

This fails the run. Where it is wrong about your code, // ramonda-check-ignore <reason> on the line says so, and the reason is printed on every run.

Reported when a heading is more than one level below the heading before it, both written in the same render.

Headings are the document's outline, not a set of sizes. A screen reader exposes them as a navigable list with a level each — for many readers it is how a page is read at all — so a jump from h1 to h3 announces a section nested inside one that does not exist.

Use the next level down and style it however you like; font-size is a stylesheet's decision and the level is the document's.

Going back UP is not reported: an h3 followed by an h2 is one section ending and another beginning, which is what an outline does.

Next

• All rules — the other checks this one runs beside.
• Checking your app — how to run it, and what it proves.