Qu'est-ce qu'une hiérarchie de titres Markdown ?

Les titres Markdown sont définis à l'aide du symbole # — un # pour H1, deux pour H2, jusqu'à six pour H6. Ils forment l'épine dorsale structurelle d'un document, similaire à une table des matières. Un document bien structuré utilise les titres dans un ordre logique et imbriqué : H1 comme titre de niveau supérieur, H2 pour les sections principales, H3 pour les sous-sections, et ainsi de suite.

Lorsque les titres sont utilisés hors d'ordre — par exemple, en passant directement de H2 à H4 — cela rompt le plan sémantique et peut nuire à l'accessibilité (les lecteurs d'écran s'appuient sur l'ordre des titres) et au SEO (les moteurs de recherche utilisent les titres pour comprendre la hiérarchie du contenu). Visualiser la hiérarchie permet d'identifier facilement ces problèmes avant la publication.

Description de l'outil

Cet outil analyse le texte Markdown et affiche tous les titres basés sur # sous forme d'arbre interactif et repliable. Vous pouvez voir en un coup d'œil comment votre document est structuré, identifier les niveaux de titre ignorés et compter le nombre de titres de chaque type.

Les titres à l'intérieur des blocs de code délimités (``` ou ~~~) sont ignorés, de sorte que la sortie ne reflète que la structure réelle du document.

Exemples

Entrée :

# Démarrage

## Installation

### Prérequis

### Étapes

## Configuration

# Utilisation avancée

## Plugins

Arbre de sortie :

H1  Démarrage
├── H2  Installation
│   ├── H3  Prérequis
│   └── H3  Étapes
└── H2  Configuration
H1  Utilisation avancée
└── H2  Plugins

Fonctionnalités

  • Analyse tous les titres H1–H6 de n'importe quel texte Markdown
  • Affiche les titres sous forme d'arbre interactif et repliable avec des contrôles de développement/réduction
  • Ignore les titres à l'intérieur des blocs de code délimités (``` et ~~~)
  • Affiche le nombre de titres par niveau (H1–H6) et un nombre total de titres
  • Prend en charge la profondeur d'expansion initiale configurable

Cas d'utilisation

  • Révision de documentation — Vérifiez qu'un long README ou une page de documentation a une structure de titres cohérente et bien ordonnée avant la publication.
  • Audit SEO — Vérifiez que le contenu destiné au web utilise un seul H1 et une imbrication logique H2/H3 pour aider les robots des moteurs de recherche à comprendre la structure de la page.
  • Vérification de l'accessibilité — Assurez-vous que les niveaux de titre ne sont pas ignorés, ce qui est un problème d'accessibilité courant signalé par les directives WCAG.

Fonctionnement

L'outil analyse la source Markdown ligne par ligne. Toute ligne commençant par un à six caractères # suivis d'un espace est traitée comme un titre. Un algorithme à deux passes collecte d'abord tous les titres dans l'ordre, puis construit un arbre en suivant une pile de nœuds parents ouverts — chaque nouveau titre est imbriqué sous le titre précédent le plus proche d'un niveau inférieur.

Conseils

  • Collez un fichier Markdown complet, y compris le préambule — l'outil ignore les lignes non-titre, de sorte que le préambule YAML et le texte du corps n'affecteront pas la sortie.
  • Utilisez le paramètre Profondeur d'expansion initiale pour réduire automatiquement les niveaux d'imbrication profonds et obtenir d'abord un aperçu de haut niveau.
  • Décochez Développer tout avant d'explorer un grand document pour commencer réduit et explorer des sections spécifiques.