Une table des matières pour tout fichier Markdown, en cinq secondes
Les longs fichiers de documentation (un README de 800 lignes, un changelog, un guide de déploiement) sont difficiles à lire sans table des matières en haut. Les lecteurs veulent sauter à « Troubleshooting » ou « API reference » d'un clic, pas faire défiler dix écrans.
Cet outil lit votre Markdown, collecte chaque titre (H1 à H6) et construit une liste à puces imbriquée avec liens vers les ancres. Les liens fonctionnent immédiatement sur GitHub, GitLab, Docusaurus, Astro et la plupart des générateurs de sites statiques.
Nous ignorons les titres à l'intérieur de blocs de code fences (`# n'est pas un H1 s'il est dans un \`\`\`bash`). Le générateur prend en charge trois styles d'ancres (GitHub, GitLab, Plain), un mode « insertion dans le document », des marqueurs `<!-- TOC -->` optionnels pour les outils d'auto-update, et une bascule « ignorer le premier H1 ».
Mode d'emploi
- Collez votre Markdown dans le panneau de gauche. Un court exemple est chargé par défaut pour que l'outil ait quelque chose à traiter.
- Réglez la plage de profondeur avec les curseurs, les valeurs par défaut sont H1 à H4. Si vous ne voulez pas les plus petits titres, mettez le max à H3. Si vous ne voulez que les sections de premier niveau, mettez le max à H2.
- Choisissez un style d'ancre : GitHub (le plus courant, fonctionne aussi sur GitLab et Docusaurus), GitLab (très proche, petites différences pour les chiffres en tête), Plain (slugify classique, ASCII uniquement).
- Activez « Numbered list » si vous préférez `1.` à `-`. Les numéros s'ajustent automatiquement au rendu (GitHub affiche 1, 2, 3 même si chaque entrée est `1.`).
- « Skip first H1 » : si la première ligne du fichier est le titre du document (par exemple le nom du projet dans un README), vous ne le voulez généralement pas dans la TOC. Basculez l'interrupteur.
- « Insert mode » : au lieu de la seule TOC, le générateur renvoie le document complet avec la TOC insérée juste après le premier H1. Pratique quand vous avez un gros fichier existant et voulez ajouter une TOC sans édition manuelle.
- Copiez la TOC (ou le document complet en mode insert) et collez dans votre fichier. Ou téléchargez sous forme de fichier .md.
Quand c'est utile
Situations concrètes où une table des matières est rentable :
- Un gros README open-source. Le fichier a 12 sections : « Installation », « Quick start », « Configuration », « API », « Examples », « Troubleshooting », « Contributing », « License ». Sans TOC, l'utilisateur scrolle. Avec une TOC, il clique et atterrit.
- Un CHANGELOG.md avec des dizaines de versions. Une TOC qui pointe vers chaque version (`## v1.4.2, 12/10/2025`, `## v1.4.1, 08/10/2025`, ...) permet aux lecteurs de sauter à la release qui les intéresse en un clic. Générez la TOC une fois, ajoutez les nouvelles versions en haut, la TOC se met à jour à la main ou via un outil comme `markdown-toc`.
- Doc technique sur Docusaurus / Astro / MkDocs. Certains thèmes affichent une TOC dans la sidebar automatiquement, mais une TOC en-page aide encore pour les longs articles. Générez-la ici, collez-la dans le fichier, c'est fait.
- Migration de docs depuis Confluence / Notion. Les exports de ces outils arrivent rarement avec une TOC utilisable. Collez, générez, collez le résultat en haut.
- Un livre ou un article long en Markdown. Les livres techniques sont souvent écrits en Markdown (Pragmatic Bookshelf, Manning). Chaque chapitre a besoin d'un index de sections.
- Doc interne d'entreprise. Le README du repo d'infra, un runbook d'incident, un doc d'onboarding, tout ce qui dépasse 5 sections.
Si vous construisez un README de zéro, utilisez notre générateur de README, il ajoute la TOC automatiquement. Après mise en ordre, passez le fichier dans notre linter Markdown, il attrape les erreurs courantes de liens d'ancrage.