Générez une table des matières depuis Markdown
Transformez vos titres en table des matières avec liens, prête à coller : dans l’exemple, Project Guide, Installation et Usage sont indentés par niveau, et le second Requirements reçoit l’ancre requirements-1 pour que les deux liens fonctionnent. Gratuit dans votre navigateur.
- Gratuit
- Fonctionne dans votre navigateur
- Sans inscription
- Vos données restent sur votre appareil
Lancer gratuitement
Transformez un document Markdown en table des matières claire et cliquable sans recopier les titres ni calculer les ancres à la main. Le générateur lit les titres ATX précédés de dièses et les titres Setext soulignés, ignore les faux titres placés dans des blocs de code délimités, puis renvoie du Markdown prêt à coller ainsi que des données structurées. Les titres imbriqués reçoivent une indentation adaptée et les intitulés répétés obtiennent des ancres distinctes. Le traitement est déterministe, n’utilise pas le réseau et signale clairement tout document dépourvu de titres.
Collez votre Markdown et obtenez un plan prêt à l’emploi
Saisissez l’intégralité de la source Markdown dans le champ de texte. Le générateur parcourt le document dans l’ordre de lecture et reconnaît les titres ATX du niveau un au niveau six, comme <code>## Installation</code>. Il reconnaît également les titres Setext, composés d’une ligne de texte suivie de signes égal pour le niveau un ou de tirets pour le niveau deux.
Le résultat contient une chaîne <code>toc</code> que vous pouvez coller directement au début d’un README, d’un guide, d’une spécification ou d’un article de base de connaissances. Chaque entrée utilise la syntaxe Markdown ordinaire des liens, tandis que l’indentation reflète l’écart entre son niveau et le titre le moins profond du document. La hiérarchie reste ainsi fidèle même si un extrait commence au niveau deux.
La réponse fournit aussi un tableau structuré <code>headings</code> indiquant le niveau, le texte visible et l’ancre générée de chaque entrée.
Comprenez comment un titre devient un lien stable
Une table des matières n’est utile que si chaque lien vise le même identifiant de fragment que celui produit pour le titre correspondant. Ce générateur applique une transformation prévisible inspirée de GitHub : il passe les lettres en minuscules, remplace les espaces par des tirets, supprime la plupart des signes de ponctuation et conserve les lettres et chiffres d’autres langues. Le balisage Markdown en ligne est retiré du libellé visible et de l’ancre ; ainsi, <code>Options **avancées**</code> donne le libellé lisible « Options avancées » et l’ancre <code>options-avancées</code>.
Les liens gardent leur texte affiché plutôt que leur URL de destination. Si un même titre nettoyé apparaît plusieurs fois, le premier utilise l’ancre de base, le deuxième reçoit le suffixe <code>-1</code>, puis la numérotation continue. Les lignes ressemblant à des titres dans les blocs de code délimités sont ignorées, tout comme les titres vides qui ne permettraient aucune navigation utile.
Intégrez le résultat à vos flux documentaires
Le flux le plus simple consiste à coller la chaîne <code>toc</code> sous le titre du document et à la régénérer dès que les titres changent. Dans une automatisation, appelez la capacité une fois la documentation assemblée, puis comparez la chaîne renvoyée à la table des matières versionnée. Une différence peut déclencher une mise à jour pendant la revue sans imposer un moteur de rendu Markdown complet.
Les générateurs de sites statiques peuvent plutôt exploiter les enregistrements structurés pour créer des barres latérales, des index de page ou une navigation mobile tout en respectant l’ordre et l’imbrication de la source. L’analyseur n’effectue aucun appel réseau, n’exécute pas le HTML intégré et ne modifie pas le Markdown transmis. Il produit uniquement des données de navigation.
L’entrée est limitée à un million de caractères.
Cas d’usage
Maintenez l’index d’un README à jour
Régénérez le plan lié lorsque des sections sont ajoutées, renommées, déplacées ou imbriquées au cours d’une version.
Créez la navigation de votre documentation
Exploitez le tableau structuré des titres pour produire une barre latérale ou un index sans entretenir un second plan manuellement.
Contrôlez la documentation en intégration continue
Comparez le résultat généré à la table versionnée et signalez toute navigation obsolète pendant la revue du code.
Questions fréquentes
Quels styles de titres Markdown sont pris en charge ?
Les titres ATX de H1 à H6 et les titres Setext H1 ou H2 sont reconnus. Les faux titres dans les blocs de code délimités sont ignorés.
Que se passe-t-il lorsque des titres se répètent ?
Le premier titre utilise l’ancre de base. Les suivants ayant le même texte nettoyé reçoivent des suffixes numériques tels que -1 et -2.
Le générateur modifie-t-il mon Markdown ?
Non. Il renvoie une nouvelle chaîne de table des matières et des enregistrements structurés sans réécrire le texte source.
Comment les noms d’ancre sont-ils formés ?
À la manière de GitHub : les lettres passent en minuscules, les espaces deviennent des tirets et presque toute la ponctuation disparaît, tandis que les lettres et chiffres d’autres langues sont conservés. Un titre comme Advanced **options** donne l’ancre advanced-options.
Les titres situés dans des blocs de code sont-ils inclus ?
Non. Les lignes qui ressemblent à des titres dans un bloc de code sont ignorées, ce qui compte dans les tutoriels sur Markdown. Les titres vides sont aussi écartés, et un document sans aucun titre produit une erreur claire au lieu d’une table vide.
Outils associés
Pour les développeurs — accès API
Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.
Endpoint
Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.
Appeler depuis votre stack
curl -X POST https://api.kit.forhosting.com/dev2/markdown-toc-generate \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"# Project Guide\n\n## Installation\n\n### Requirements\n\n## Usage"}'const res = await fetch("https://api.kit.forhosting.com/dev2/markdown-toc-generate", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"text": "# Project Guide\n\n## Installation\n\n### Requirements\n\n## Usage"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/dev2/markdown-toc-generate",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"text": "# Project Guide\n\n## Installation\n\n### Requirements\n\n## Usage"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev2/markdown-toc-generate", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"text":"# Project Guide\\n\\n## Installation\\n\\n### Requirements\\n\\n## Usage"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"text":"# Project Guide\n\n## Installation\n\n### Requirements\n\n## Usage"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev2/markdown-toc-generate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemple de requête
{
"text": "# Project Guide\n\n## Installation\n\n### Requirements\n\n## Usage"
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "dev2.markdown_toc_generate",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.
Tarifs
Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.
Limites
max_chars | 1000000 |
Erreurs
| HTTP | Code | Signification |
|---|---|---|
401 | unauthorized | Clé API absente ou invalide : vérifiez l’en-tête Authorization. |
402 | insufficient_balance | Solde insuffisant : rechargez votre compte pour lancer cette tâche. |
404 | unknown_type | Type de tâche inconnu : vérifiez le champ type de votre requête. |
429 | rate_limited | Trop de requêtes : ralentissez la cadence, puis réessayez. |
Notes techniques
Intégrez le résultat à vos flux documentaires
Un document contenant du texte, des listes, du code ou des tableaux, mais aucun titre valide, renvoie une erreur <code>invalid_input</code> plutôt qu’une table vide.
Questions techniques
Que se passe-t-il si le document ne contient aucun titre ?
La requête renvoie une erreur invalid_input précisant qu’aucun titre Markdown n’a été trouvé.
Combien coûte une requête API ?
Chaque requête API coûte $0.002. La version pour navigateur peut exécuter localement la même logique déterministe.