Vai al contenuto principale
LibraTool logoLibraTool

Generatore Albero ASCII gratis

Trasforma un elenco indentato in un albero di cartelle pulito (├── └──) per README e documentazione. Output Unicode o ASCII semplice. Funziona interamente nel tuo browser.

Funziona offline una volta caricato
Opzioni di importazione
Per impostazione predefinita vengono saltati node_modules, .git, output di build e cache.

Indenta con spazi o tab per annidare gli elementi. Ogni livello di indentazione diventa un figlio. Aggiungi una nota dopo ' # ', ' // ', ' - ' o ' <- ' e verrà allineata come commento nell'output. Incolla un elenco di percorsi (git ls-files, find, dir /s /b) per annidarli; termina un nome con / per segnare una cartella vuota. Importare o trascinare una cartella o un .zip legge solo i nomi dei file, mai il loro contenuto, e salta node_modules, .git e altre cartelle di build (vedi Opzioni di importazione).

Albero
Stile del commento
my-project
├── src
│   ├── components
│   │   ├── Button.tsx
│   │   └── Modal.tsx
│   ├── lib
│   │   └── utils.ts
│   └── index.ts  # entry point
├── public
│   └── favicon.ico
├── package.json
└── README.md

💡 Incolla una struttura di cartelle (o qualsiasi schema annidato) e ottieni un albero pulito da inserire in un README, un commento o nella documentazione. Usa lo stile ASCII negli ambienti che non renderizzano i caratteri box-drawing. Tutto viene eseguito nel browser.

Usi comuni

  • Aggiungi un albero di cartelle a un READMEGenera un albero di struttura del progetto pulito per documentare il tuo repository.
  • Documenta una struttura di progettoCrea un albero di directory per documenti tecnici e wiki.
  • Crea un albero per un commento di codiceGenera un diagramma di struttura da incorporare nei commenti del codice sorgente.
  • Mostra un albero di file in una presentazioneCrea un diagramma di directory pulito per diapositive e tutorial.
  • Trasforma un'outline in un alberoVisualizza qualsiasi outline annidato — non solo file — come un albero.

Come funziona

Documentare una struttura di cartelle in un README normalmente significa disegnare le righe ├── e └── a mano. Questo le genera da un semplice elenco rientrato.

  1. 1
    Digiti uno schema rientrato
    Un elemento per riga; rientra con spazi o tabulazioni per annidare. La profondità del rientro definisce la gerarchia.
  2. 2
    Viene analizzato in un albero
    Un parser basato su stack trasforma il rientro in una struttura annidata, interamente nel tuo browser.
  3. 3
    I connettori dell'albero vengono disegnati
    Vengono generati i ├──, └── e guide │ corretti, con le righe verticali corrette portate attraverso i rami annidati.
  4. 4
    Copia il risultato
    Scegli i connettori Unicode o ASCII semplice e copia l'albero nel tuo README, documenti o commento di codice.

Un semplice strumento di testo che viene eseguito interamente sul tuo dispositivo — niente è caricato.

Guida

Esempio pratico

La pagina si apre con un esempio di 12 righe: "my-project" con "src", "public", "package.json" e "README.md" sotto, e "components", "lib" e "index.ts" sotto "src". Con lo stile predefinito "├── Unicode", ├── segna un elemento con un fratello sotto, └── segna l'ultimo, e │ porta un ramo verso il basso. Una nota scritta come "index.ts # punto di ingresso" appare come "index.ts # punto di ingresso", con ogni nota allineata in una colonna due spazi dopo la riga più lunga che ne ha una. Premi "- Markdown" per elenchi puntati annidati (due spazi per livello) o "|-- ASCII" per caratteri semplici. Incollare i tre percorsi src/app/page.tsx, src/app/layout.tsx e src/lib/utils.ts produce src con app (page.tsx, layout.tsx) e lib (utils.ts) sotto.

Quali impostazioni usare, e i limiti

  • Scegli lo stile per il luogo in cui andrà l'albero. "├── Unicode" ha l'aspetto migliore nei README e nei documenti. "|-- ASCII" usa solo caratteri semplici, per terminali, log e commenti nel codice dove i caratteri di disegno potrebbero non essere visualizzati. "- Markdown" crea un elenco puntato. "Scarica" salva tree.txt, o tree.md nello stile Markdown.
  • Annida con i rientri, o incolla percorsi. Ogni rientro più profondo crea un figlio della riga sopra. Una tabulazione conta come quattro spazi, e il tasto Tab nella casella inserisce due spazi (Shift+Tab li rimuove; premi Esc e poi Tab per uscire dalla casella). Puoi anche incollare un elenco di percorsi come l'output di git ls-files, find o dir /s /b, con separatori / o \, e questi si fondono in un unico albero. Termina un nome con / per indicare una cartella vuota.
  • Aggiungi note dopo un delimitatore. Metti " # ", " // ", " - " o " <- " dopo un nome, con uno spazio su ciascun lato, e il resto della riga diventa una nota, allineata in una colonna. "Stile commento" sceglie se l'output mostra #, // o <--. Un nome che contiene uno spazio, un trattino e un altro spazio, come "Mio Doc - finale.docx", viene diviso in un nome e una nota, quindi scrivilo senza gli spazi attorno al trattino.
  • Ordina prima le cartelle e contrassegnale con una barra. "Prima le cartelle" mette le cartelle prima dei file a ogni livello e per il resto mantiene il tuo ordine. "/ finale" aggiunge un / dopo ogni cartella, cioè ogni nome che ha figli o che hai terminato con /.
  • Importa nomi da una cartella o da uno zip. "Importa cartella" (nascosto sui telefoni), trascinare una cartella sulla casella, o "Importa .zip" legge solo i nomi dei file, mai il contenuto. Sotto "Opzioni di importazione", "Ignora nomi (separati da virgola, * consentito)" salta per impostazione predefinita node_modules, .git, dist, build, .next, __pycache__, .venv e altre solite cartelle di build, e "Profondità massima" parte da 7 e va da 1 a 30. La profondità conta le cartelle sopra un file, inclusa la cartella principale. Una nota indica quanti file sono stati saltati.

Problemi comuni e come risolverli

L'albero risulta piatto, senza rami.
Niente era indentato, quindi ogni riga è diventata un elemento di primo livello a sé. Indenta i figli con spazi o il tasto Tab. L'unica eccezione è un elenco di percorsi (nomi contenenti / o \), che viene annidato automaticamente, ma solo se nessuna delle righe è indentata.
Parte di un nome file appare come nota.
Uno spazio, poi #, //, - o <-, poi un altro spazio inizia una nota. "Mio Doc - finale.docx" diventa il nome "Mio Doc" con la nota "finale.docx". Rimuovi gli spazi attorno al trattino, come in "Mio Doc-finale.docx". Un # o - senza uno spazio su entrambi i lati, come in "C# notes.md", rimane nel nome.
Dice "Impossibile leggere quel .zip. Verifica che sia un file zip valido e non crittografato."
Il file non ha potuto essere aperto come zip: potrebbe essere danneggiato, protetto da password, o non essere realmente uno zip. Crea uno zip normale e riprova. "Quel .zip non ha voci." significa che l'archivio è vuoto.
Mancano dei file dopo aver importato una cartella.
Guarda la nota sotto la casella, come "12 file saltati (ignorati o troppo profondi)". I file vengono saltati quando un nome di cartella o file corrisponde a "Ignora nomi", o quando si trovano a una profondità maggiore di "Profondità massima". Apri "Opzioni di importazione" e modifica l'elenco o aumenta la Profondità massima; la modifica viene applicata alla tua ultima importazione a meno che tu non abbia modificato il testo nel frattempo. Inoltre, una cartella trascinata viene letta solo fino a circa 50.000 nomi prima che venga applicato l'elenco da ignorare, quindi un progetto con un'enorme node_modules può perdere file reali: usa invece "Importa cartella" o uno zip creato senza node_modules.
Dice "Impossibile leggere la cartella o il file trascinato."
Il browser ha rifiutato di elencare l'elemento trascinato. Usa invece "Importa cartella", oppure crea un .zip e usa "Importa .zip". Sui telefoni l'opzione cartella è nascosta, quindi usa uno zip lì.

Come si confronta

Per una cartella che già possiedi, il comando tree (o tree /f su Windows) in un terminale fornisce un elenco esatto in un solo passaggio, e questo strumento può cambiarne lo stile. Usa questo strumento quando vuoi pianificare una struttura che non esiste ancora, mostrare solo una parte di una cartella, aggiungere note, o passare da Unicode ad ASCII e Markdown. Funziona solo con i nomi, senza dimensioni, date, permessi o contenuti, e un'importazione salta le comuni cartelle di build a meno che tu non modifichi l'elenco. Tra gli stili, Unicode si legge meglio ma i suoi caratteri di disegno potrebbero non apparire in alcuni posti, ASCII è la scelta sicura per terminali e commenti nel codice, e Markdown è per elenchi che devono essere visualizzati come punti elenco.

Strumenti correlati

Domande frequenti