Markdown: cos’è e come si usa questo linguaggio di markup
Il markdown è un linguaggio di markup leggero per testo semplice, nato per restare leggibile anche prima della conversione in HTML grazie a simboli come cancelletti, asterischi e trattini che indicano titoli, elenchi, enfasi e collegamenti.
In questa pagina markdown indica il linguaggio di markup leggero per testo semplice, oggi centrale nell’ambito GEO perché è il formato che i modelli linguistici leggono e generano con maggiore efficienza. Nato per rendere leggibile un testo anche prima della conversione in HTML, il markdown usa simboli come cancelletti, asterischi e trattini per indicare titoli, elenchi, enfasi e collegamenti.
In breve
- Cosa risolve: permette di strutturare un testo con pochi caratteri, senza editor visuali o codice HTML esteso.
- Quando si applica: serve per documentazione tecnica, note, contenuti web e file destinati a essere letti sia da persone sia da sistemi automatici.
- Condizioni e limiti: la sintassi originale di John Gruber presenta ambiguità che varianti come CommonMark hanno standardizzato; non tutti i motori di rendering interpretano allo stesso modo elementi come tabelle o note a piè di pagina.
- Come si verifica: un file scritto in markdown si controlla aprendo il sorgente in un editor di testo semplice: deve restare comprensibile anche senza conversione in HTML.
- Cosa fare: per iniziare basta un editor di testo qualunque e la conoscenza dei simboli base (#, *, -, [ ]()).
- Tempo di apprendimento: la sintassi essenziale si assimila in pochi minuti, gli usi avanzati (tabelle, blocchi di codice annidati) richiedono qualche ora di pratica.
Che cos’è il markdown e a cosa serve
Il markdown è un linguaggio di markup leggero creato nel 2004 da John Gruber, con il contributo di Aaron Swartz che nello stesso periodo aveva sviluppato atx, un formato di testo strutturato simile. L’obiettivo dichiarato era permettere di scrivere in un formato di puro testo, facile da leggere anche senza conversione, e trasformabile in XHTML o HTML tramite uno script.
A differenza dei formati di scrittura “pesanti” come RTF o HTML, il markdown non introduce tag visibili invasivi: un titolo resta leggibile anche scritto come ## Titolo, un elenco resta riconoscibile anche con un semplice trattino davanti a ogni voce. Questa caratteristica lo rende adatto sia alla lettura umana sia all’elaborazione automatica, perché la struttura logica del documento è già visibile nel testo grezzo, senza bisogno di interpretare tag annidati.
Significato del termine markdown
Il termine markdown deriva dal gioco di parole con “markup”: mentre un linguaggio di markup complesso “marca” il testo con tag, il markdown lo fa con simboli minimi, quasi impercettibili nella lettura. Nell’uso tecnico e nella GEO il termine non ha una vera traduzione italiana consolidata: si usa la forma inglese anche nei testi in lingua italiana, riservando il significato di “ribasso di prezzo” esclusivamente all’ambito del commercio al dettaglio, estraneo a questo argomento.
Un file markdown ha estensione .md o .markdown ed è identificato dal tipo MIME text/markdown. Essendo un file di puro testo, non richiede software proprietario: si apre e si modifica con qualsiasi editor, dal blocco note più semplice agli ambienti di sviluppo più completi, e resta leggibile anche a distanza di anni, indipendentemente dal programma che lo ha creato.
Sintassi di base del markdown
La sintassi del markdown si costruisce con un numero ridotto di simboli, ciascuno associato a un elemento di formattazione preciso. Conoscere questi elementi è sufficiente per scrivere un documento completo senza mai aprire un editor visuale.
Intestazioni e titoli
I titoli si ottengono anteponendo da uno a sei simboli cancelletto seguiti da uno spazio: un cancelletto produce un titolo di primo livello, due un sottotitolo, fino a sei livelli di profondità. È necessario lasciare una riga vuota prima e dopo il titolo perché venga interpretato correttamente dalla maggior parte dei motori di rendering.
Grassetto, corsivo e testo sbarrato
Il grassetto si ottiene racchiudendo il testo tra due coppie di asterischi o di trattini bassi, il corsivo con una singola coppia; combinando i due simboli si ottiene grassetto e corsivo insieme. Il testo sbarrato, non presente nella specifica originale ma comune nelle estensioni moderne, si ottiene con due tilde su ogni lato della parola.
Elenchi puntati e numerati
Un elenco puntato inizia ogni riga con un trattino, un asterisco o un segno più, seguito da uno spazio; un elenco numerato usa una cifra seguita da un punto. I sotto-elenchi si ottengono indentando la riga di due spazi o con un tabulatore; cambiare il simbolo del trattino con l’asterisco all’interno dello stesso blocco forza l’inizio di un nuovo elenco.
Link, immagini e indirizzi email
Un collegamento si scrive racchiudendo il testo visibile tra parentesi quadre e l’indirizzo tra parentesi tonde; per le immagini si usa la stessa struttura preceduta da un punto esclamativo, con il testo alternativo al posto del testo del link. Per creare un link che apre direttamente un client di posta si inserisce l’indirizzo preceduto da mailto: al posto dell’URL, ad esempio [Scrivi](mailto:indirizzo@esempio.it).
Citazioni e blocchi di codice
Una citazione inizia con il simbolo maggiore seguito da uno spazio; più righe consecutive precedute dallo stesso simbolo formano un’unica citazione a blocco. Il codice inline si racchiude tra singoli apici inversi, mentre un blocco di codice multiriga si delimita con tre apici inversi consecutivi prima e dopo il testo, spesso seguiti dal nome del linguaggio per abilitare l’evidenziazione della sintassi.
Tabelle in markdown
| Elemento | Sintassi | Effetto |
|---|---|---|
| Intestazione colonne | | Col1 | Col2 | |
Riga di intestazione della tabella |
| Separatore | |---|---| |
Riga che definisce i confini delle colonne |
| Allineamento | |:---|---:| |
Allinea il contenuto a sinistra o a destra |
Escape dei caratteri speciali
Quando un simbolo come l’asterisco o il cancelletto deve comparire come carattere letterale e non come istruzione di formattazione, si inserisce una barra rovesciata subito prima del carattere, ad esempio *testo non in corsivo*. Questa procedura, detta escape, evita che il motore di rendering interpreti erroneamente la punteggiatura come sintassi.
Dove si usa il markdown
Il markdown si è diffuso in contesti molto diversi tra loro, mantenendo sempre lo stesso principio: separare il contenuto dalla formattazione senza appesantire il file sorgente.
Documentazione tecnica e file README
Nello sviluppo software il markdown è lo standard per i file README, i manuali dei progetti e le pagine di documentazione ospitate su piattaforme di versionamento del codice. La sua adozione in questi contesti deriva dalla possibilità di versionare il testo insieme al codice sorgente, tracciando ogni modifica con gli stessi strumenti.
Note personali e produttività
Numerose applicazioni di gestione delle note salvano i contenuti in formato markdown proprio per garantirne la portabilità: un file di note resta apribile e modificabile anche cambiando applicazione, perché il testo grezzo non dipende da un formato proprietario.
Pubblicazione web e contenuti
Blog, siti statici e manuali tecnici vengono spesso scritti in markdown e poi convertiti in HTML in fase di pubblicazione. Questo flusso separa la scrittura, che avviene in un formato semplice, dalla presentazione finale, gestita da un motore di conversione o da un generatore di siti statici.
Cos’è un file markdown (.md)
Un file con estensione .md è un documento di puro testo che contiene la sintassi markdown non ancora convertita: aprendolo con un editor qualsiasi se ne legge il contenuto in chiaro, con i simboli di formattazione ancora visibili. La conversione in HTML, PDF o altri formati avviene solo quando il file viene elaborato da uno strumento dedicato.
Perché il markdown è centrale per l’intelligenza artificiale
I modelli linguistici di grandi dimensioni interpretano il markdown in modo naturale perché la loro fase di addestramento include enormi quantità di testo proveniente da repository di codice, wiki e documentazione tecnica scritta proprio in questo formato. Riconoscere un cancelletto come intestazione o un trattino come voce di elenco non richiede quindi un’elaborazione aggiuntiva da parte del modello.
Efficienza dei token e struttura chiara
Rispetto a HTML o XML, il markdown usa un numero minore di caratteri per esprimere la stessa struttura, lasciando più spazio nella finestra di contesto del modello per il contenuto effettivo. Titoli, elenchi e blocchi di codice restano riconoscibili con pochi simboli, senza tag di apertura e chiusura ripetuti, riducendo il rumore che un modello deve filtrare prima di elaborare l’informazione.
Il markdown come formato delle risposte generative
Molti sistemi di intelligenza artificiale generano le proprie risposte direttamente in markdown, perché è il formato più semplice per restituire testo con una gerarchia visibile senza dover produrre un documento HTML completo. Applicazioni come ChatGPT, ad esempio, interpretano correttamente titoli, grassetti ed elenchi scritti con questa sintassi e li restituiscono formattati nell’interfaccia di chat.
File di istruzioni per agenti AI
Nei flussi di lavoro basati su agenti automatici, file di contesto e di istruzioni vengono spesso scritti in markdown proprio per la loro leggerezza: la struttura a intestazioni permette all’agente di individuare rapidamente le sezioni rilevanti senza dover analizzare un formato più complesso come un documento Word o un PDF con layout multipli.
Come convertire una conversazione con un assistente AI in markdown
Quando un’applicazione di intelligenza artificiale genera già la risposta in markdown, è sufficiente copiare il testo grezzo così come viene mostrato, mantenendo intatti i simboli di formattazione, per ottenere un file .md pronto da salvare o da incollare in un editor che supporta questa sintassi.
Markdown a confronto con HTML, PDF e DOCX
Il markdown non sostituisce HTML: lo precede nel flusso di lavoro. Un documento scritto in markdown viene normalmente convertito in HTML per la pubblicazione web, mentre per la lettura o la modifica del sorgente resta preferibile il formato di partenza.
| Formato | Leggibilità del sorgente | Elaborazione da parte di un’AI | Uso tipico |
|---|---|---|---|
| Markdown | Alta, senza conversione | Diretta, minimo rumore | Documentazione, note, prompt |
| HTML | Bassa, tag visibili | Richiede pulizia dai tag non semantici | Pagine web pubblicate |
| Bassa, layout fisso | Richiede estrazione del testo dal layout | Documenti stampabili definitivi | |
| DOCX | Media, dipende dall’editor | Richiede conversione dal formato proprietario | Documenti aziendali modificabili |
Se devi scegliere tra markdown e HTML
Se il contenuto deve restare leggibile e modificabile da più persone nel tempo, conviene scrivere in markdown e generare l’HTML solo al momento della pubblicazione. Se invece serve un controllo preciso sul layout finale, con stili, classi ed elementi interattivi, il markdown da solo non basta e serve intervenire direttamente in HTML.
Se un documento deve alimentare un sistema di intelligenza artificiale
Se il documento di partenza è in PDF o DOCX, conviene convertirlo in markdown prima di fornirlo a un modello, perché il sistema non deve più interpretare layout, immagini incorporate o stili complessi e può concentrare l’elaborazione sul contenuto testuale.
Varianti e standardizzazione del markdown
La specifica originale pubblicata da Gruber nel 2004, con la versione 1.0.1 rilasciata il 17 dicembre dello stesso anno, conteneva ambiguità che diversi sviluppatori hanno interpretato in modo differente nel tempo, generando comportamenti non uniformi tra un’implementazione e l’altra.
CommonMark, la specifica non ambigua
CommonMark è la specifica pubblicata nel 2014 da un gruppo di sviluppatori con l’obiettivo di eliminare le ambiguità della sintassi originale, accompagnata da una suite di test che permette di verificare se un motore di rendering produce output coerenti con lo standard. È oggi il riferimento più solido per chi sviluppa strumenti che elaborano markdown.
Estensioni e varianti diffuse
Accanto a CommonMark esistono estensioni come MultiMarkdown, Markdown Extra e la variante usata dalle piattaforme di sviluppo collaborativo, che aggiungono funzionalità non previste dalla specifica originale, come tabelle, note a piè di pagina ed elenchi di controllo con caselle selezionabili. Ogni variante resta compatibile con la sintassi di base, ma non tutte le estensioni sono supportate da ogni motore di conversione: prima di usare una funzione avanzata è necessario verificare quale variante interpreta il documento.
Strumenti per scrivere e convertire file markdown
Scrivere in markdown non richiede software dedicato, ma esistono strumenti che semplificano l’anteprima e la conversione del testo.
Editor con supporto nativo
Editor generici come Visual Studio Code offrono l’anteprima in tempo reale del markdown, mentre applicazioni dedicate come Typora mostrano direttamente il testo formattato mentre viene digitato, senza separare la vista del sorgente da quella del risultato. Per una prova rapida senza installare nulla, un anteprima live nel browser mostra il risultato della conversione mentre si scrive.
Convertitori e librerie di conversione
Per trasformare un file markdown in un altro formato si usano convertitori universali capaci di gestire markdown, HTML, DOCX e altri formati di documento in ingresso e in uscita. In ambiente Python, librerie dedicate al parsing del markdown permettono di integrare la conversione direttamente in uno script, elaborando il testo sorgente e restituendo HTML o altre strutture dati.
Passaggi per creare e convertire un file markdown
- Apri un editor di testo semplice e crea un nuovo file con estensione
.md. - Scrivi il contenuto usando la sintassi di base: cancelletti per i titoli, asterischi per il grassetto, trattini per gli elenchi.
- Salva il file mantenendo l’estensione
.mdper preservarne la riconoscibilità da parte di editor e strumenti di conversione. - Elabora il file con uno strumento di conversione per ottenere HTML, PDF o un documento compatibile con Word, a seconda della destinazione finale.
Markdown per la stampa
Il markdown non è un formato pensato per la stampa diretta: quando un documento deve essere stampato, si converte prima in PDF tramite uno strumento di conversione, così da fissare l’impaginazione prima dell’output cartaceo.
Errori frequenti e limiti del markdown
Il markdown semplifica la scrittura, ma alcuni errori ricorrenti compromettono la resa del documento convertito.
Mancanza di righe vuote tra gli elementi
Molti motori di rendering richiedono una riga vuota prima e dopo un titolo o un blocco di codice: ometterla porta spesso a una formattazione mancata, con il testo che resta invariato invece di trasformarsi nell’elemento previsto.
Differenze tra implementazioni non standardizzate
Una sintassi avanzata come le tabelle o le note a piè di pagina non fa parte della specifica originale: un documento che le usa può apparire correttamente su una piattaforma e in modo diverso su un’altra, se i due motori di conversione seguono varianti differenti.
Limiti nel controllo del layout
Il markdown non permette di definire margini, colori o posizionamenti complessi: quando il progetto richiede un controllo preciso sulla presentazione visiva, è necessario integrare direttamente HTML e fogli di stile, che restano comunque compatibili all’interno di molti documenti markdown.
Domande frequenti
Cos’è il markdown?
Il markdown è un linguaggio di markup leggero creato nel 2004 da John Gruber per scrivere testo semplice, leggibile anche senza conversione, e trasformabile in HTML tramite pochi simboli come cancelletti, asterischi e trattini.
Cosa significa markdown in ambito AI?
In ambito AI il markdown è il formato con cui molti modelli linguistici generano e interpretano il testo strutturato, perché la sua sintassi minima riduce i caratteri necessari a esprimere titoli, elenchi ed enfasi rispetto a HTML.
Il markdown è meglio dell’HTML?
Non sono alternative dirette: il markdown è più semplice da scrivere e leggere allo stato grezzo, mentre l’HTML offre un controllo completo sul layout. Per la pubblicazione, il markdown viene spesso convertito in HTML.
ChatGPT capisce il markdown?
Sì, i sistemi conversazionali basati su modelli linguistici interpretano correttamente la sintassi markdown e la usano anche per formattare le proprie risposte, mostrando titoli, elenchi e grassetti già formattati nell’interfaccia.
Il markdown è difficile da imparare?
No, la sintassi di base si assimila in pochi minuti perché si compone di pochi simboli ricorrenti; solo le estensioni avanzate, come tabelle complesse o note a piè di pagina, richiedono più pratica.
L’intelligenza artificiale preferisce il markdown o l’HTML?
Tendenzialmente preferisce il markdown per l’elaborazione di testo destinato all’analisi, perché richiede meno caratteri e meno elaborazione per riconoscere la struttura del documento rispetto ai tag HTML.
Quali sono gli svantaggi del markdown?
Il limite principale è il controllo ridotto sul layout visivo e la mancanza di uno standard unico per le funzionalità avanzate, che può causare rese differenti tra piattaforme diverse dello stesso documento.
Come si esegue l’escape dei caratteri speciali in markdown?
Si inserisce una barra rovesciata subito prima del simbolo che deve comparire come carattere letterale, ad esempio davanti a un asterisco o a un cancelletto, per evitare che venga interpretato come istruzione di formattazione.
