PreviewMD per Mac, iPad e iPhone
Scarica

Che cos’è Markdown, da dove viene e a cosa serve

Risposta breve: Markdown è un modo di scrivere testo formattato dentro un file di testo semplice, con segni che una persona legge senza bisogno di alcun programma. Una riga che inizia con # è un titolo, **like this** è grassetto, una riga che inizia con - è una voce di elenco. Un convertitore trasforma tutto questo in HTML; una persona lo legge bene in entrambi i casi. Quella doppia vita — leggibile come testo, renderizzabile come documento — è l’idea intera, ed è il motivo per cui è sopravvissuto a tutti i formati più sofisticati arrivati per sostituirlo.

Da dove viene

Markdown è stato pubblicato nel marzo del 2004 da John Gruber, che lo ha scritto con Aaron Swartz. L’implementazione era uno script Perl di circa 1 400 righe chiamato Markdown.pl, e l’obiettivo era dichiarato senza giri di parole: chi scriveva per il web era stanco di battere a mano i tag HTML, e la posta elettronica aveva già insegnato a tutti a marcare il testo in modo informale.

Quest’ultimo punto conta, perché Markdown non ha inventato i suoi segni. Li ha raccolti dalle convenzioni che la gente usava già nella posta in testo semplice:

  • circondare una parola di asterischi per dare enfasi, come usenet e la posta facevano da vent’anni
  • citare una risposta mettendo > all’inizio delle righe, come faceva ogni client di posta
  • sottolineare un titolo con === o ---, che veniva da Setext, un formato del 1992 di Ian Feldman
  • mettere # davanti a un titolo, che veniva da atx, scritto da Aaron Swartz nel 2002

Il contributo di Gruber è stata la selezione e la regola che le sta dietro: un documento Markdown deve leggersi come un documento di testo, non come un documento coperto di tag. Niente, nella sintassi, dovrebbe somigliare a del markup per chi non sa che Markdown esiste.

Il nome è una battuta alle spalle del markup, e la licenza originale era abbastanza permissiva perché chiunque potesse reimplementarlo — cosa che hanno fatto tutti.

Perché si è diffuso

Markdown è arrivato senza un comitato, senza un’azienda e senza uno standard, e si è ritrovato comunque in ogni angolo. Ci sono riuscite tre sue proprietà.

È testo semplice, quindi ogni strumento lo tratta già. Il controllo di versione lo confronta riga per riga e ti mostra cosa è cambiato dentro un paragrafo: prova a farlo con il file di un elaboratore di testi. La ricerca lo trova. Uno script può generarlo. Sopravvive a un invio per posta, a un incollaggio in chat e a una seconda copia. Fra quarant’anni si aprirà ancora.

Impararlo costa cinque minuti. Con tre segni sei già produttivo, e il resto lo scopri quando ti serve. Niente è nascosto dietro una barra degli strumenti.

Decade con grazia. Chi non ha un renderer Markdown vede asterischi e cancelletti, ma legge comunque il testo nell’ordine giusto, con la struttura in chiaro. Di nessun formato binario si può dire lo stesso.

Le piattaforme che l’hanno adottato presto l’hanno reso la scelta ovvia. Stack Overflow è nato nel 2008 con un editor Markdown. GitHub mostrava README.md renderizzato nelle pagine dei progetti, e da lì «scrivi il README in Markdown» è diventata la convenzione di un intero settore. Jekyll, pubblicato lo stesso anno, trasformava cartelle di file Markdown in siti web, e GitHub Pages li serviva gratis.

Nel 2016 il formato era abbastanza diffuso da essere registrato presso la IANA come tipo di media text/markdown, nell’RFC 7763.

Le varianti, e perché sono più di una

La descrizione originale di Gruber lasciava dei casi indefiniti: cosa accade quando un elenco viene interrotto, come si annida l’enfasi dentro una parola, cosa significa una parentesi quadra spaiata. Ogni implementazione li ha risolti a modo suo, così lo stesso file appariva diverso in strumenti diversi.

Nel 2014 un gruppo di cui faceva parte John MacFarlane, autore di Pandoc, ha scritto una specifica precisa con una suite di test. È stata pubblicata come «Standard Markdown», Gruber ha protestato per il nome e si è passati a CommonMark. Quella specifica è ciò che segue oggi la maggior parte dei renderer.

Variante Cosa aggiunge Dove la incontri
CommonMark La base precisa: regole senza ambiguità e una suite di test Gran parte delle librerie e degli editor
GitHub Flavored Markdown Tabelle, elenchi di attività, barrato, collegamenti automatici, note a piè di pagina, riquadri di avviso GitHub, GitLab, quasi tutti i README
MultiMarkdown Citazioni, riferimenti incrociati, metadati, tabelle migliori Scrittura accademica e testi lunghi
Pandoc Markdown Tutto quanto sopra più matematica, figure e output in PDF, Word, LaTeX Articoli, libri, tesi
MDX Componenti scritti in JSX, incorporati nel testo Siti di documentazione costruiti con React

GFM è ciò che la maggior parte delle persone intende oggi quando dice Markdown: è CommonMark più le estensioni specificate da GitHub nel 2017. PreviewMD rende GFM, con la matematica affidata a KaTeX e i diagrammi a Mermaid.

Per cosa lo si usa

Documentazione e README. La scelta naturale per tutto ciò che legge chi sviluppa: readme di progetto, changelog, note di architettura, manuali operativi. I siti di documentazione — MkDocs, Docusaurus, Hugo, Astro — sono soprattutto cartelle di Markdown con un tema sopra.

Appunti. Obsidian, Bear, iA Writer, Logseq e una dozzina di altri salvano gli appunti come file Markdown, il che significa che i tuoi appunti non sono in trappola: puoi leggerli con qualunque editor, farne il backup con qualunque strumento e passare a un’altra app senza un passaggio di esportazione.

Scrivere per il web. Siti statici, newsletter e blog dove chi scrive vuole scrivere prosa e non markup. Il testo che stai leggendo è un file Markdown; il selettore in cima alla pagina te lo mostra.

Ovunque una casella di testo accetti la formattazione. Issue tracker, pull request, app di chat, forum e wiki usano Markdown o un suo parente stretto.

Parlare con le macchine. I modelli linguistici producono Markdown per impostazione predefinita, cosa che ne ha fatto in silenzio la lingua franca fra le persone e gli strumenti di IA: i titoli, gli elenchi e i blocchi di codice che vedi nella risposta di un assistente sono Markdown reso.

I suoi limiti

Markdown è un formato di struttura, non di impaginazione. Non ha modo di dire dove una cosa sta sulla pagina, quanto è larga una colonna o quale carattere usare — ed è voluto, perché quelle decisioni spettano a chi rende il documento.

Perciò si adatta male quando è la forma della pagina a contare: un volantino, un modulo, una doppia pagina di rivista. Le tabelle complesse con celle unite sono scomode e finiscono quasi sempre in HTML. E per la scrittura accademica con citazioni e riferimenti incrociati il Markdown semplice non basta da solo: è per questo che esistono le estensioni di Pandoc e di MultiMarkdown.

La lamentela più comune — «il mio file appare diverso in un’altra app» — è quasi sempre una differenza di variante. Scrivere in CommonMark più GFM è la scommessa più sicura, perché è ciò su cui concorda il maggior numero di strumenti.

Markdown su un Mac

macOS non rende i .md di serie: la barra spaziatrice mostra testo semplice, e una cartella di appunti sembra una pila di icone bianche identiche.

PreviewMD sistema esattamente quella parte: anteprime in Quick Look, miniature dei documenti e una finestra con la pagina renderizzata accanto al suo sorgente. Rende GitHub Flavored Markdown, con la matematica di KaTeX e i diagrammi di Mermaid inclusi nell’app, quindi non si scarica nulla mentre un documento viene reso.

Il prontuario elenca ogni segno con ciò che produce, e come aprire un file .md su un Mac copre il lato pratico.