Générateur de Table des Matières Markdown | Sommaire prêt à coller

Collez un document Markdown et récupérez une table des matières à placer directement en tête de votre README ou de votre article. Choisissez la profondeur des titres, le style à puces ou numéroté et les ancres GitHub : le Markdown formaté apparaît dans le volet de sortie.

💡 À propos de cet outil

Quand on entretient une documentation longue, garder le sommaire à jour devient une corvée répétitive : à chaque réorganisation d'une section, la table des matières écrite à la main se désynchronise du corps. Un titre renommé casse son lien d'ancre, un nouveau ## n'arrive jamais dans la liste, et le lecteur tombe sur un lien mort.

Cet outil reconstruit le sommaire à partir des titres eux-mêmes, si bien que la structure reflète toujours le contenu. L'indentation utilise deux espaces et se calcule par rapport au titre le moins profond rencontré : un document qui commence à ## n'entraîne donc pas de niveau vide. Les ancres GitHub suivent la règle de slug de GitHub — minuscules, espaces convertis en tirets, et tout ce qui n'est pas a-z, 0-9, tiret ou underscore est retiré — pour que les liens fonctionnent sans retouche.

🧐 Questions fréquentes

Le H1 est-il inclus ? Vous choisissez la profondeur de H2 à H6. En conservant le titre de page comme unique H1 et en démarrant le sommaire à H2, vous obtenez un plan net du corps sans répéter le titre.

Les ancres GitHub fonctionnent-elles vraiment ? Elles respectent l'algorithme de slug de GitHub, donc pour des titres en alphabet latin les liens se résolvent directement. La ponctuation et les emojis sont retirés, comme le fait GitHub. Si un titre produit une ancre vide, passez le style sur Aucune pour obtenir une liste en texte simple.

Confond-il les commentaires # dans les blocs de code ? Non. Tout ce qui se trouve dans un bloc ouvert par ``` ou ~~~ est ignoré jusqu'à la clôture correspondante, si bien que les invites shell ou les commentaires Python ne sont jamais pris pour des titres.

Comment les listes numérotées sont-elles numérotées ? Chaque élément est émis sous la forme 1.. Les moteurs de rendu Markdown numérotent automatiquement les listes ordonnées : laisser 1. partout dans la source est la pratique courante.

Qu'est-ce qui détermine la profondeur d'indentation ? Le niveau de titre le moins profond présent sert de référence et tout le reste s'indente par rapport à lui, ce qui préserve la hiérarchie visuelle que le document commence à H2 ou à H3.

📚 Bonnes pratiques pour un sommaire fiable

L'intérêt d'un sommaire généré tient à un principe simple : il devient un produit dérivé du contenu, et non un fichier que l'on maintient à la main. Sur un dépôt collaboratif, c'est précisément la table des matières écrite manuellement qui vieillit le plus vite, car les contributeurs ajoutent des sections sans penser à mettre la liste à jour. Comme le slug est calculé de la même manière que GitHub le calcule, vous évitez le décalage classique entre un titre lu « Mise en place » et une ancre tapée à la main en #mise-en-place mal orthographiée. La bonne habitude consiste à régénérer le sommaire dès que le plan change plutôt qu'à le corriger ligne par ligne.