Generatore TOC Markdown
Genera un indice collegato dai titoli markdown.
Informazioni sullo strumento
Un indice (TOC) Markdown è un elenco di navigazione in cima a un documento che aiuta i lettori a saltare rapidamente a sezioni specifiche. Questo generatore estrae automaticamente i titoli dal tuo codice Markdown e crea ancore collegate compatibili con GitHub, GitLab e la maggior parte dei renderer Markdown. Elimina il tedioso lavoro manuale di scrivere voci di indice e garantisce che i link rimangono precisi man mano che il tuo documento si evolve.
Incolla il tuo testo Markdown e fai clic su Genera per creare istantaneamente un indice formattato con link ancora funzionanti. Lo strumento supporta opzioni personalizzabili: controlla la profondità massima dei titoli (da H1 a H6) da includere e scegli il tuo stile di punto elenco preferito (trattini, asterischi o simboli di più). I titoli duplicati vengono rilevati automaticamente e numerati con suffissi come #heading-1, #heading-2 per evitare conflitti di ancoraggio.
Domande Frequenti
Implementazione del Codice
import re
def heading_to_anchor(text: str) -> str:
"""Convert heading text to a GitHub-Flavored Markdown anchor."""
anchor = text.lower()
anchor = re.sub(r"[^\w\s-]", "", anchor) # remove punctuation (keep letters, digits, -, _)
anchor = re.sub(r"\s+", "-", anchor.strip()) # spaces → hyphens
return anchor
def generate_toc(markdown: str, max_depth: int = 3, bullet: str = "-") -> str:
lines = []
seen: dict[str, int] = {}
for line in markdown.splitlines():
m = re.match(r"^(#{1,6})\s+(.*)", line)
if not m:
continue
level = len(m.group(1))
if level > max_depth:
continue
title = m.group(2).strip()
anchor = heading_to_anchor(title)
# Deduplicate: second occurrence → anchor-1, third → anchor-2, ...
count = seen.get(anchor, 0)
seen[anchor] = count + 1
if count > 0:
anchor = f"{anchor}-{count}"
indent = " " * (level - 1)
lines.append(f"{indent}{bullet} [{title}](#{anchor})")
return "\n".join(lines)
md = """# Getting Started
## Installation
### Prerequisites
### Install
## Configuration
## Usage
# Advanced
## Performance
## Security
"""
print(generate_toc(md, max_depth=3, bullet="-"))
# - [Getting Started](#getting-started)
# - [Installation](#installation)
# - [Prerequisites](#prerequisites)
# - [Install](#install)
# - [Configuration](#configuration)
# - [Usage](#usage)
# - [Advanced](#advanced)
# - [Performance](#performance)
# - [Security](#security)Comments & Feedback
Comments are powered by Giscus. Sign in with GitHub to leave a comment.