Entrée
Résultat
Le résultat apparaîtra ici.Une table des matières n’est utile que si chaque lien mène quelque part, et les ancres écrites à la main se cassent de façon prévisible : GitHub supprime la ponctuation, conserve les caractères chinois, met tout en minuscules et numérote les titres répétés -1, -2 dans l’ordre du document. Cet outil lit votre Markdown, repère chaque titre situé hors des blocs de code délimités et du front matter, et écrit une liste imbriquée dont les ancres suivent les mêmes règles que github-slugger, la bibliothèque qui reproduit le comportement de github.com. Il peut aussi placer la liste entre les marqueurs <!-- toc --> et <!-- tocstop -->, la convention de l’outil en ligne de commande markdown-toc, si bien qu’une nouvelle exécution remplace l’ancienne liste au lieu d’en ajouter une deuxième.
Comment ça marche
- Les titres en # comme les titres soulignés (=== et ---) sont repérés ; les lignes dans des blocs ``` ou ~~~, le front matter YAML et les commentaires HTML sont ignorés.
- Les ancres sont construites à partir du texte que GitHub affiche : liens, emphase et code en ligne sont réduits à leur texte, la ponctuation est supprimée, les espaces deviennent des tirets.
- Chaque titre compte dans la numérotation -1, -2 des doublons, y compris ceux plus profonds que la profondeur choisie, car GitHub les numérote tous.
- Réglez la profondeur maximale, le style de puce, l’omission éventuelle du titre du document (un H1 initial) et le renvoi du document entier avec la liste insérée entre les marqueurs.
Où vont vos données
Nulle part. Cet outil s’exécute entièrement dans votre navigateur : le texte collé est traité par la page, jamais transmis à un serveur ni consigné dans un journal.
Cet outil est gratuit et ne demande aucun compte. Ses résultats n’existent que dans la page ouverte et ne sont enregistrés nulle part.
Ce que ça coûte
Cet outil est gratuit, sans connexion ni points.
Questions fréquentes
- Pourquoi l’ancre d’un titre chinois conserve-t-elle les caractères ?
- Parce que GitHub les conserve. Sa règle de slug ne retire que la ponctuation et les symboles : ## 安装与使用 pointe donc vers #安装与使用 et ## FAQ：为什么选择 Rust？ vers #faq为什么选择-rust — les deux-points et le point d’interrogation pleine chasse disparaissent, les caractères restent. Les navigateurs encodent le lien en pourcentage lorsqu’ils le suivent, ce qui est normal.
- Les liens fonctionneront-ils sur GitLab ou Gitea ?
- En grande partie. GitLab et Gitea transforment les titres en slugs de façon très proche, et les titres anglais simples produisent la même ancre partout. Ils diffèrent dans des cas limites — titres répétés, certains signes de ponctuation, texte non latin sur les anciennes versions —, donc sur un autre site que GitHub, cliquez une fois sur les liens après publication.
- Comment mettre à jour la table des matières après avoir ajouté des sections ?
- Placez <!-- toc --> seul sur une ligne à l’endroit où doit figurer la liste, puis <!-- tocstop --> après, activez l’insertion entre les marqueurs et traitez le document entier. Tout ce qui se trouve entre les marqueurs est remplacé, et les titres de l’ancienne liste sont ignorés : une nouvelle exécution donne donc le même résultat au lieu d’une liste qui s’allonge à chaque fois.
- Lit-il les titres écrits en HTML, comme <h2> ?
- Non. Seuls les titres Markdown sont listés — les lignes en # et les lignes soulignées par === ou ---. Une balise <h2> dans le Markdown est exclue de la liste ; réécrivez-la en ## si vous voulez qu’elle y figure.
L’open source derrière
Cet outil est une implémentation autonome, sans bibliothèque tierce. jonschlinkert/markdown-toc (MIT) fait le même travail sous forme de bibliothèque : pour l’intégrer à votre programme, commencez par là plutôt que d’appeler une page web.
jonschlinkert/markdown-tocAussi appelé
- générateur table des matières markdown
- markdown toc
- table des matières readme
- ancres markdown github
- générer sommaire markdown
- markdown toc generator