Markdown en entrée

TOC généré

Exemples de TOC Markdown

Générer des liens d'ancre à partir des titres. Exemple :

Titres du manuel du projet

Markdown en entrée :

Entrée

TOC généré :

Sortie

Utilisez Exemple ci-dessus pour charger plus de titres.

Qu'est-ce qu'un générateur TOC Markdown ?

Une table des matières (TOC) aide les lecteurs à naviguer dans les documents longs. En Markdown, les titres utilisent # jusqu'à ######. Un générateur TOC scanne vos titres et produit une liste de liens vers chaque section. GitHub Flavored Markdown et de nombreux générateurs de sites statiques prennent en charge les liens d'ancre générés à partir du texte du titre.

Cet outil s'exécute dans votre navigateur. Collez du Markdown ou téléchargez un fichier ; le TOC se met à jour à l'édition. Vous pouvez définir les niveaux min et max des titres (ex. uniquement H2–H4). Les slugs d'ancre sont créés à partir du texte du titre et dédupliqués en cas de répétition. Pour formater le Markdown : Formateur Markdown. Pour convertir en HTML : Markdown vers HTML.

Comment utiliser cet outil

1

Coller ou télécharger du Markdown

Collez votre Markdown dans l'éditeur de gauche ou cliquez sur Télécharger pour charger un fichier .md, .markdown ou .txt. Utilisez Exemple pour charger des titres d'exemple. Le TOC se met à jour automatiquement.

2

Définir la plage de niveaux de titres

Utilisez Min H1–H4 et Max H3–H6 pour inclure uniquement certains niveaux. Par ex., Min H2 et Max H4 ignore H1 et H5–H6. Garde les docs longs focalisés.

3

Copier ou télécharger le TOC

Copiez le TOC généré dans le presse-papiers ou téléchargez-le. Collez au début de votre README ou doc. Pour le lint Markdown : Linter Markdown. Pour l'aide syntaxe : Aide-mémoire Markdown.

Quand la génération TOC aide

Les README sur GitHub, les sites de documentation et les wikis bénéficient d'un TOC. Les lecteurs peuvent sauter aux sections sans défilement. La spécification CommonMark définit la syntaxe des titres ; GFM et la plupart des moteurs de rendu prennent en charge les liens #anchor-slug. Les générateurs statiques comme Eleventy et VitePress génèrent souvent les ancres automatiquement.

Pour créer des tableaux à partir de CSV ou de données délimitées : Générateur de tableaux Markdown. Pour la référence de syntaxe : Aide-mémoire Markdown. Pour Markdown vers HTML : Markdown vers HTML.

Questions fréquentes

Comment les slugs d'ancre sont-ils créés ?

Les titres sont mis en minuscules, les caractères spéciaux supprimés, les espaces remplacés par des tirets. Les titres dupliqués reçoivent un suffixe numérique (ex. #intro-1, #intro-2).

Fonctionne-t-il avec GitHub ?

Oui. GitHub génère des ancres à partir des titres. Collez le TOC au début de votre README ; les liens fonctionneront dans la vue rendue.

Les titres dans les blocs de code sont-ils inclus ?

Non. Les titres dans les blocs de code délimités (```) sont ignorés pour que les exemples de code ne soient pas confondus avec la structure du document.

Puis-je limiter la profondeur ?

Oui. Utilisez les menus Min/Max niveau. Par ex., Min H2 et Max H4 produit un TOC uniquement avec les titres H2, H3 et H4.

Mes données sont-elles envoyées à un serveur ?

Non. La génération TOC s'exécute entièrement dans votre navigateur. Aucune donnée n'est envoyée ni stockée.

Outils associés

En savoir plus : CommonMark, spécification CommonMark, GitHub Flavored Markdown, Markdown Guide, GitHub, W3C HTML, Eleventy, VitePress.