Prüfen Sie Überschriftenhierarchie und H1-Fehler

Eine Überschriftenhierarchie kann auf dem Bildschirm richtig wirken, obwohl die zugrunde liegenden Tags etwas anderes aussagen. Dieses Prüfwerkzeug verarbeitet Tags in Dokumentreihenfolge, etwa h1, h2, h3 und h2, und wendet zwei klare Regeln an: Es muss genau eine h1 geben, und keine Überschrift darf auf einmal um mehr als eine Ebene absteigen. Das Ergebnis zeigt Gültigkeit, H1-Anzahl und die genaue Position jedes Sprungs, damit Redaktionsteams und Veröffentlichungssysteme die Fehler beheben können.

Bereiten Sie die Tags in Dokumentreihenfolge vor

Beginnen Sie mit den Überschriften-Tags in genau der Reihenfolge, in der sie im gerenderten Dokument vorkommen, nicht in einer Designvorlage oder redaktionellen Gliederung. Eine typische Eingabe kann h1, h2, h3, h2, h3 lauten. Die Reihenfolge ist entscheidend, weil sich die Hierarchie aus dem Übergang von einer Überschrift zur nächsten ergibt.

Das Werkzeug akzeptiert Tags von h1 bis h6, entfernt äußere Leerzeichen und behandelt Großschreibungen wie H2 genauso wie Kleinschreibungen. Beliebiges HTML, Überschriftentexte, CSS-Klassen oder einzelne Zahlen werden nicht akzeptiert. Extrahieren Sie solche Informationen vor der Anfrage, damit eine eindeutige Tag-Liste entsteht.

Eine leere Liste gilt als ungültige Eingabe, weil keine Dokumentstruktur bewertet werden kann. Ein fehlerhafter Eintrag wird ebenfalls abgelehnt und mit seinem Index benannt, wodurch sich Probleme bei der Extraktion leichter finden lassen. Diese Trennung ist in Pipelines nützlich: Die Extraktion ermittelt vorhandene Tags, während diese Fähigkeit ausschließlich deren Reihenfolge und Ebenen bewertet.

Verstehen Sie die beiden Hierarchieregeln

Die erste Regel verlangt genau eine h1 in der vollständigen Liste. Ohne h1 fehlt dem Dokument eine eindeutige Überschrift der obersten Ebene; bei zwei oder mehr h1 wird diese Hauptebene wiederholt. Die zweite Regel untersucht jedes benachbarte Paar und meldet einen Sprung, wenn die folgende Zahl um mehr als eins größer ist als die vorherige.

Beim Wechsel von h2 zu h4 fehlt daher eine h3. Beim Wechsel von h1 zu h5 fehlen in diesem Übergang h2, h3 und h4. Ein Aufstieg von h4 zurück zu h2 ist erlaubt, weil damit verschachtelte Inhalte geschlossen werden und das Dokument zu einem übergeordneten Abschnitt zurückkehrt.

Auch dieselbe Ebene darf wiederholt werden; aufeinanderfolgende h2 können gleichrangige Abschnitte einleiten. Das Werkzeug meldet sämtliche Sprünge und beendet die Prüfung nicht nach dem ersten. Jeder Eintrag enthält den nullbasierten Zielindex, den Übergang sowie alle fehlenden Zwischenebenen.

Gültig ist das Ergebnis nur bei genau einer h1 und einer leeren Sprungliste.

Nutzen Sie das Ergebnis für Reviews und Freigaben

Verwenden Sie das Gültigkeitsfeld für eine einfache Freigabeentscheidung und bewahren Sie die Detailfelder für hilfreiche Korrekturhinweise auf. Die Gesamtzahl bestätigt, wie viele Tags geprüft wurden, und die H1-Anzahl erklärt, ob die oberste Regel erfüllt ist. Jeder Ebenensprung verweist auf den Zielindex des fehlerhaften Abstiegs.

Dadurch können Redaktionen oder Build-Werkzeuge die betreffende Überschrift ohne Auslegung eines unklaren Textes finden. Die Problemliste bietet kurze englische Zusammenfassungen für Protokolle, Review-Kommentare oder Content-Management-Oberflächen. Diese Fähigkeit bewertet weder Formulierung und Keywords noch visuelle Größe, leeren Überschriftentext oder die ideale Abschnittszahl.

Sie ruft außerdem keine URL ab und analysiert kein HTML; bei einer Webseite müssen Sie zunächst die geordneten Tags extrahieren. Da der Algorithmus ohne Netzwerk, Zufall, Uhrzeit und verborgenen Zustand arbeitet, erzeugt dieselbe Liste immer dieselbe Antwort.