Publié en mars 2026

Table des matières auto-générée pour Markdown

Les longs fichiers Markdown ont besoin de navigation. Une table des matières générée à partir des titres rend n’importe quel document facile à parcourir. ShowMeMyMD en génère une automatiquement — sans tags, sans plugins, sans outils CLI.

## Le problème

Markdown n’a pas de TOC intégrée

Markdown ne possède pas de syntaxe de table des matières. Il n’y a pas de balise [TOC] dans la spécification. Certains outils en supportent une, la plupart non.

Alors les gens contournent le problème. Les générateurs CLI comme markdown-toc et doctoc injectent du Markdown de TOC dans votre fichier. VS Code a des extensions pour ça. GitHub en génère automatiquement une pour les fichiers README sur le web.

Rien de tout cela n’est automatique. Vous devez soit modifier votre fichier, soit installer des outils. Et quand vous changez un titre, la TOC est obsolète jusqu’à ce que vous relancez quelque chose.

## Comment ShowMeMyMD gère ça

Ouvrez un fichier. La TOC est déjà là.

Ouvrez n’importe quel fichier .md avec des titres — # à ###### — et ShowMeMyMD génère une table des matières cliquable automatiquement.

Pas de tags à insérer. Pas de plugins à installer. Pas d’outils CLI à exécuter. Pas de configuration. Ouvrez simplement votre fichier et naviguez.

Détail clé

La TOC est générée au moment du rendu. Votre fichier .md n’est jamais modifié. Changez un titre, et la TOC se met à jour instantanément la prochaine fois que vous ouvrez le fichier.

## Pourquoi c’est important

Les longs documents ont besoin de navigation

Tout document avec une structure bénéficie d’une TOC cliquable. Sautez à la section dont vous avez besoin au lieu de défiler à travers des centaines de lignes.

Fichiers README

Projets open-source avec sections installation, utilisation, docs API et contribution. Allez directement à ce dont vous avez besoin.

Documentation

Spécifications techniques, références API, runbooks. Une TOC transforme un mur de texte en ressource navigable.

Notes de réunion

Points d’ordre du jour, décisions, actions à suivre. Retrouvez la décision de la semaine dernière sans relire tout le document.

Spécifications techniques

Décisions d’architecture, documents de design, RFC. Naviguez dans les documents complexes par section.

## Alternatives

Autres moyens d’obtenir une TOC Markdown

TOC manuelle

Écrire des liens Markdown vers les ancres de titres à la main. Quelque chose comme [Installation](#installation) pour chaque section. Fastidieux à écrire, se casse quand les titres changent, et vous devez le maintenir vous-même.

markdown-toc (npm)

Un outil CLI qui génère une TOC et l’insère sous forme de texte Markdown dans votre fichier. Fonctionne, mais nécessite Node.js, npm install, et de relancer la commande à chaque changement de titre. Modifie votre fichier source.

Extensions VS Code

Plusieurs extensions VS Code ajoutent la génération de TOC. Elles fonctionnent dans VS Code, mais vous avez besoin de VS Code ouvert — un IDE complet juste pour naviguer dans un document.

GitHub

GitHub génère automatiquement une TOC pour les fichiers README sur le web. Cliquez sur l’icône hamburger à côté du nom de fichier. Mais cela ne fonctionne que sur GitHub.com — pas pour les fichiers locaux sur votre Mac.

## La solution simple

Ouvrez simplement votre fichier

ShowMeMyMD génère une table des matières à partir de vos titres automatiquement. Sans modification de vos fichiers. Non destructif. Fonctionne avec n’importe quelle structure de titres de # à ######.

La TOC est toujours à jour parce qu’elle est générée à partir du fichier tel qu’il est actuellement — pas à partir d’un instantané en cache ou d’un bloc injecté qui pourrait être obsolète.

## Continuer la lecture

Arrêtez de défiler. Commencez à naviguer.

$2.99. Achat unique. Sans abonnement. Sans compte.

Télécharger dans leMac App Store