Pubblicato marzo 2026

Indice dei contenuti auto-generato per Markdown

I file Markdown lunghi hanno bisogno di navigazione. Un indice dei contenuti generato dalle intestazioni rende qualsiasi documento consultabile. ShowMeMyMD ne genera uno automaticamente — nessun tag, nessun plugin, nessuno strumento CLI.

## Il problema

Markdown non ha un TOC integrato

Markdown non ha una sintassi per l’indice dei contenuti. Non esiste un tag [TOC] nelle specifiche. Alcuni strumenti ne supportano uno, la maggior parte no.

Quindi si ricorre a soluzioni alternative. Generatori CLI come markdown-toc e doctoc inseriscono il TOC in Markdown nel tuo file. VS Code ha estensioni per questo. GitHub ne genera uno automaticamente per i file README sul web.

Niente di tutto ciò è automatico. Devi modificare il file o installare strumenti. E quando cambi un’intestazione, il TOC è obsoleto finché non riesegui qualcosa.

## Come lo gestisce ShowMeMyMD

Apri un file. Il TOC è già lì.

Apri qualsiasi file .md con intestazioni — da # a ###### — e ShowMeMyMD genera un indice dei contenuti cliccabile automaticamente.

Nessun tag da inserire. Nessun plugin da installare. Nessuno strumento CLI da eseguire. Nessuna configurazione. Apri il file e naviga.

Dettaglio chiave

Il TOC viene generato al momento del rendering. Il tuo file .md non viene mai modificato. Cambia un’intestazione e il TOC si aggiorna istantaneamente alla prossima apertura del file.

## Perché conta

I documenti lunghi hanno bisogno di navigazione

Qualsiasi documento strutturato beneficia di un TOC cliccabile. Vai direttamente alla sezione che ti serve invece di scorrere centinaia di righe.

File README

Progetti open-source con sezioni di installazione, utilizzo, docs API e contribuzione. Vai dritto a ciò che ti serve.

Documentazione

Specifiche tecniche, riferimenti API, runbook. Un TOC trasforma un muro di testo in una risorsa navigabile.

Note riunioni

Punti all’ordine del giorno, decisioni, azioni da intraprendere. Trova la decisione della scorsa settimana senza rileggere l’intero documento.

Specifiche tecniche

Decisioni architetturali, documenti di design, RFC. Naviga documenti complessi per sezione.

## Alternative

Altri modi per ottenere un TOC Markdown

TOC manuale

Scrivi link Markdown alle ancore delle intestazioni a mano. Qualcosa come [Installazione](#installazione) per ogni sezione. Noioso da scrivere, si rompe quando cambiano le intestazioni, e devi mantenerlo da solo.

markdown-toc (npm)

Uno strumento CLI che genera un TOC e lo inserisce come testo Markdown nel file. Funziona, ma richiede Node.js, npm install e riesecuzione del comando ogni volta che cambiano le intestazioni. Modifica il file sorgente.

Estensioni VS Code

Diverse estensioni VS Code aggiungono la generazione del TOC. Funzionano dentro VS Code, ma ti serve VS Code aperto — un IDE completo solo per navigare un documento.

GitHub

GitHub genera automaticamente un TOC per i file README sul web. Clicca l’icona hamburger accanto al nome del file. Ma funziona solo su GitHub.com — non per i file locali sul tuo Mac.

## Il modo semplice

Apri semplicemente il tuo file

ShowMeMyMD genera un indice dei contenuti dalle tue intestazioni automaticamente. Nessuna modifica ai tuoi file. Non distruttivo. Funziona con qualsiasi struttura di intestazioni da # a ######.

Il TOC è sempre aggiornato perché viene generato dal file così com’è in quel momento — non da uno snapshot in cache o un blocco inserito che potrebbe essere obsoleto.

## Continua a leggere

Smetti di scorrere. Inizia a navigare.

$2.99. Acquisto unico. Nessun abbonamento. Nessun account.

Scarica dalMac App Store