Il Markdown è un modo di formattare il testo scrivendo dei simboli normali dentro il testo stesso. Metti un asterisco attorno a una parola e diventa in corsivo; metti un cancelletto all’inizio di una riga e quella riga diventa un titolo. Niente barre degli strumenti, niente menu a tendina: la formattazione è fatta degli stessi caratteri che stai già digitando.
L’ha inventato John Gruber nel 2004, con il contributo di Aaron Swartz, con un obiettivo dichiarato: un documento in Markdown deve restare leggibile anche così com’è, prima ancora di essere convertito in qualcosa. È il motivo per cui funziona ancora vent’anni dopo, ed è la differenza fra il Markdown e l’HTML.
Prova a modificare il pannello qui sotto: quello che scrivi a sinistra si compone a destra mentre digiti.
# Un titolo
Un paragrafo con del **testo in grassetto**, un po' di
*corsivo* e un [collegamento](https://www.inkiostro.app).
- Un elenco puntato
- Con due voci
> Una citazione.
`codice in linea` e niente più.Un titolo
Un paragrafo con del testo in grassetto, un po’ di corsivo e un collegamento.
- Un elenco puntato
- Con due voci
Una citazione.
codice in linea e niente più.
Come funziona il Markdown
Un file Markdown è un file di testo semplice, di solito con estensione .md. Dentro non c’è niente di nascosto: nessuna formattazione invisibile, nessun formato proprietario, nessun modo di aprirlo e trovare caratteri illeggibili. Puoi aprirlo con qualsiasi cosa — TextEdit, il Blocco note, un terminale — e capirlo.
Il passaggio in più lo fa il compositore: un programma legge quei simboli e produce il documento formattato. Può essere l’anteprima live del tuo editor, un sito che pubblica l’articolo, o l’esportazione in PDF. Lo stesso file può diventare cose diverse senza essere modificato.
Il punto è tutto qui: scrivi una volta il contenuto e la sua struttura, decidi dopo l’aspetto. In Word la parola in grassetto e il fatto che quella riga sia un titolo sono la stessa cosa — informazione di aspetto. In Markdown sono cose diverse: ## Titolo dice questo è un titolo di secondo livello, non questo testo è grande e nero. Ed è per questo che lo stesso file può diventare una pagina web, un PDF impaginato e un ebook senza riscriverlo.
Perché usarlo: i vantaggi
1. Resti concentrato su quello che scrivi
Non stacchi mai le mani dalla tastiera. Non cerchi un menu, non scegli un carattere, non decidi la spaziatura mentre dovresti pensare a una frase. Chi passa al Markdown lo racconta quasi sempre allo stesso modo: si scrive di più perché si smette di sistemare.
2. È testo semplice, quindi è tuo e dura
Un .docx ha bisogno di un programma che lo sappia leggere. Un .md no: è testo, e il testo si apre ovunque, oggi e fra vent’anni. Sta bene in un sistema di controllo versione come Git, si cerca con qualsiasi strumento, si sincronizza senza sorprese, e non ti lega a nessun fornitore. Se domani cambi editor, i file restano dove sono e si aprono lo stesso.
3. Si impara in pochi minuti
Titoli, grassetto, corsivo, elenchi e collegamenti coprono la quasi totalità della scrittura quotidiana, e sono cinque regole. Il resto lo si impara quando serve. Non c’è una curva di apprendimento: c’è un gradino basso e poi il piano.
4. Si converte in qualsiasi cosa
Dallo stesso file esci in PDF, HTML, EPUB, Word o testo puro. Un buon editor ci arriva in un comando — e i migliori mantengono formule e diagrammi come testo selezionabile nel PDF invece di appiattirli in immagini.
5. Si legge anche da sorgente
Questo è il criterio di progetto originale di Gruber, ed è ciò che distingue il Markdown da ogni altro linguaggio di marcatura. Guarda **importante**: capisci cosa vuol dire anche senza sapere niente di Markdown. Ora guarda <strong>importante</strong>. È la stessa informazione, ma solo una delle due si legge.
Markdown o word processor?
Non è una guerra di religione: sono strumenti per lavori diversi.
| Markdown | Word processor | |
|---|---|---|
| Formattazione | Simboli nel testo | Barre e menu |
| Formato del file | Testo semplice, aperto | Proprietario |
| Concentrazione | Alta | Bassa: l’aspetto distrae |
| Controllo versione | Nativo con Git | Difficile |
| Impaginazione fine | Limitata | Completa |
| Curva di apprendimento | Minuti | Ore |
Se devi impaginare una brochure con le immagini in posizioni precise, usa un word processor o un programma di impaginazione. Se devi scrivere — appunti, documentazione, una tesi, un articolo, un libro — il Markdown ti toglie di mezzo tutto il resto.
Chi lo usa
Più gente di quanta immagini, e non solo programmatori:
- Chi scrive e studia — appunti, bozze, tesi, articoli.
- Chi sviluppa — i file README su GitHub sono in Markdown, e così quasi tutta la documentazione tecnica.
- Chi pubblica — quasi tutti i generatori di siti statici e molte piattaforme di blog accettano Markdown direttamente.
- Chiunque prenda appunti — Obsidian, Bear, Notion e decine di altre app lo usano come formato di scrittura.
Se hai mai scritto un messaggio con gli asterischi attorno a una parola per enfatizzarla, hai già usato l’idea.
Come si comincia
Ti serve solo un editor. Puoi tecnicamente scrivere Markdown in qualsiasi editor di testo, ma senza anteprima stai scrivendo alla cieca: vedi i simboli, non il risultato.
Quello che rende la differenza è l’anteprima live — il documento formattato che si aggiorna mentre digiti. È il modo più veloce di imparare, perché ogni errore di sintassi si vede subito invece di scoprirlo dopo.
Inkiostro fa esattamente questo su Mac, iPad e iPhone: anteprima affiancata, barra di formattazione per chi non ricorda ancora i simboli, prontuario integrato ed esportazione in PDF, HTML ed EPUB. È gratuito, senza account e senza pubblicità.
Il passo successivo è la guida completa alla sintassi, che copre tutto con esempi da provare. Se invece stai scegliendo un’app, ci sono le guide sui migliori editor Markdown per Mac e per iPad.
Domande frequenti
Il Markdown è un linguaggio di programmazione?
No. È un linguaggio di marcatura: descrive la struttura di un testo, non delle istruzioni da eseguire. Non ci sono variabili, condizioni o cicli. È molto più vicino a scrivere una nota che a programmare, ed è per questo che si impara in minuti e non in settimane.
Mi serve un programma speciale per scrivere in Markdown?
No, tecnicamente basta un qualsiasi editor di testo: il Markdown è testo semplice. Ma un editor dedicato con anteprima live rende tutto molto più facile, perché vedi il documento formattato mentre scrivi invece di immaginartelo. È anche il modo più rapido di imparare la sintassi.
Che estensione hanno i file Markdown?
Quasi sempre .md. Si incontrano anche .markdown, .mdown e .mkd, ma sono varianti storiche: .md è lo standard di fatto ed è quello riconosciuto da GitHub, dagli editor e da tutti gli strumenti di conversione. Il contenuto è identico in ogni caso, perché è solo testo.
Il Markdown è meglio di Word?
Dipende dal lavoro. Per scrivere — appunti, documentazione, articoli, tesi — il Markdown è più veloce, più concentrato e produce file che restano tuoi e leggibili per sempre. Per l’impaginazione fine, le revisioni condivise con i commenti e il controllo tipografico millimetrico, Word resta più adatto.
Quanto ci vuole a imparare il Markdown?
Le basi — titoli, grassetto, corsivo, elenchi e collegamenti — si imparano in cinque minuti e coprono quasi tutto quello che scriverai. Tabelle, note a piè di pagina e blocchi di codice si aggiungono quando servono. È stato progettato apposta perché il sorgente si legga da solo, quindi anche la sintassi che non conosci si intuisce.
Che differenza c’è fra Markdown e CommonMark?
Il Markdown è la sintassi originale del 2004 di John Gruber. Il CommonMark è una specifica rigorosa e non ambigua di quella sintassi, nata perché la descrizione originale lasciava alcuni casi limite aperti a interpretazioni diverse. Quasi tutti gli editor moderni seguono il CommonMark e poi aggiungono estensioni, come le tabelle.