Vérifiez la hiérarchie des titres et les erreurs de H1

Une hiérarchie de titres peut sembler correcte à l’écran alors que les balises sous-jacentes racontent une autre histoire. Ce vérificateur reçoit les balises dans l’ordre du document, par exemple h1, h2, h3 et h2, puis applique deux règles précises : il doit exister exactement un h1 et aucun titre ne peut descendre de plus d’un niveau à la fois. La réponse indique la validité, le nombre de h1 et la position exacte de chaque saut afin que les équipes éditoriales et les systèmes de publication puissent les corriger.

Préparez la séquence dans l’ordre du document

Commencez par les balises telles qu’elles apparaissent dans le document rendu, et non dans une maquette ou un plan éditorial. Une entrée classique peut être h1, h2, h3, h2, h3. L’ordre est essentiel, car la hiérarchie résulte du passage d’un titre au suivant.

Le vérificateur accepte les balises de h1 à h6, supprime les espaces périphériques et traite les formes majuscules comme H2 de la même manière que les minuscules. Il n’accepte ni HTML arbitraire, ni texte de titre, ni classe CSS, ni nombre isolé. Extrayez ces informations avant la requête afin de conserver une liste sans ambiguïté.

Une liste vide est refusée comme entrée incorrecte puisqu’elle ne contient aucune structure à évaluer. Une balise mal formée est également refusée avec son indice, ce qui facilite le diagnostic d’une extraction défectueuse. Cette séparation convient aux pipelines : l’extraction détermine les balises présentes, tandis que cette capacité évalue uniquement leur ordre et leur niveau.

Comprenez les deux règles de hiérarchie

La première règle exige exactement un h1 dans la liste complète. Sans h1, le document ne possède pas de titre supérieur unique ; avec deux h1 ou davantage, le niveau principal est répété. La seconde règle examine chaque paire adjacente et signale un saut lorsque le nombre suivant dépasse le précédent de plus d’une unité.

Le passage de h2 à h4 indique donc qu’un h3 manque. Le passage de h1 à h5 signale l’absence de h2, h3 et h4 dans cette transition. Remonter de h4 à h2 est autorisé, car cela ferme un contenu imbriqué et revient à une section plus générale.

Répéter un niveau est également permis : deux h2 consécutifs peuvent ouvrir des sections sœurs. Le vérificateur recense tous les sauts sans s’arrêter au premier. Chaque enregistrement comprend l’indice de destination compté depuis zéro, la transition et toutes les balises intermédiaires manquantes.

Le résultat n’est valide que si le nombre de h1 vaut un et si aucun saut n’est présent.

Exploitez le résultat dans les revues et les contrôles

Utilisez le champ de validité pour décider simplement du succès ou de l’échec, puis conservez les détails afin de proposer une correction utile. Le nombre total confirme combien de balises ont été évaluées, et le décompte des h1 explique si la règle supérieure est respectée. Chaque saut désigne l’indice de destination où survient la descente incorrecte ; un éditeur ou un outil de build peut ainsi retrouver le titre sans interpréter un message ambigu.

La liste des problèmes fournit de brefs résumés en anglais pour les journaux, les commentaires de revue ou une interface de gestion de contenu. Cette capacité ne juge ni le libellé, ni les mots-clés, ni la taille visuelle, ni le texte vide, ni le nombre idéal de sections. Elle ne télécharge pas non plus d’URL et n’analyse pas le HTML : vous devez d’abord extraire les balises ordonnées.