Nel 2004, il blogger John Gruber e il programmatore Aaron Swartz pubblicarono un piccolo script Perl e una specifica di sintassi con una premessa semplice: il testo semplice dovrebbe essere leggibile così com'è, senza tag che ingombrano il contenuto, pur convertendosi pulitamente in HTML. Lo chiamarono Markdown — un gioco di parole deliberato con "markup", che suggerisce qualcosa di più leggero e umano.
Vent'anni dopo, Markdown è il formato di scrittura predefinito per la documentazione software, la comunicazione tra sviluppatori, le app di appunti e una parte significativa dei contenuti web. Ha avuto successo non perché fosse il linguaggio di formattazione più potente, ma perché era il più leggibile.
La filosofia: testo sorgente leggibile
L'obiettivo di design di Gruber era esplicito: "Un documento formattato in Markdown dovrebbe poter essere pubblicato così com'è, come testo semplice, senza sembrare marcato con tag o istruzioni di formattazione."
**grassetto**suggerisce enfasi visivamente meglio di<strong>grassetto</strong>## Titoloè scansionabile a colpo d'occhio, a differenza di<h2>Titolo</h2>- elementosembra un punto elenco anche senza rendering
Buono a sapersi Aaron Swartz, co-creatore di Markdown, è stato anche fondamentale nello sviluppo di RSS, Creative Commons e Reddit. Il suo focus sull'accesso aperto e sugli strumenti semplici e democratici è profondamente radicato nel DNA di Markdown.
Perché gli sviluppatori lo amano
- Testo semplice = amico del version control. Git può confrontare file
.mdriga per riga. Prova a farlo con un file.docx. - Nessun vendor lock-in. Un file Markdown si apre in qualsiasi editor di testo, su qualsiasi sistema operativo.
- Leggero. Un documento Markdown si misura in kilobyte, non megabyte.
- Si converte in tutto. Strumenti come Pandoc possono trasformare Markdown in HTML, PDF, EPUB, LaTeX, Word e decine di altri formati.
Dove vive Markdown oggi
| Ambito | Piattaforme che usano Markdown |
|---|---|
| Hosting del codice | GitHub, GitLab, Bitbucket |
| Comunicazione | Slack, Discord, Reddit, Teams |
| Appunti | Obsidian, Notion, Bear, Typora |
| Documentazione | Docusaurus, MkDocs, Read the Docs |
| Blogging / CMS | Jekyll, Hugo, Astro, Ghost, WordPress (tramite plugin) |
| Pubblicazione | Leanpub, mdBook, flussi di lavoro basati su Pandoc |
Il problema della frammentazione
La specifica originale di Gruber era deliberatamente informale e incompleta. La comunità ha risposto con diversi tentativi di standardizzazione:
- CommonMark (2014) — Una specifica rigorosa e inequivocabile per un comportamento prevedibile su tutti i parser.
- GitHub Flavored Markdown (GFM) — CommonMark più estensioni: tabelle, liste di attività, barrato e auto-link degli URL. Lo standard de facto per contenuti orientati agli sviluppatori.
- MDX — Markdown più componenti JSX. Usato nei siti di documentazione moderni.
- MultiMarkdown — Aggiunge note a piè di pagina, citazioni, notazione matematica e intestazioni di metadati.
- R Markdown — Markdown con blocchi di codice R incorporati che si eseguono e producono output.
La sintassi di base (titoli, grassetto, corsivo, elenchi, link, immagini, codice) funziona allo stesso modo ovunque. Le differenze sono nelle estensioni e nei casi limite.
Buono a sapersi Nonostante la frammentazione, John Gruber non ha mai appoggiato CommonMark o alcuna specifica successiva. Considera Markdown un formato di scrittura, non un linguaggio di programmazione, e lo ha intenzionalmente lasciato definito in modo flessibile.
Limitazioni e alternative
Markdown non è lo strumento giusto per tutto. È stato progettato per contenuti strutturati e incentrati sul testo. Per layout complessi, stili ricchi o profondità semantica, esistono alternative:
- AsciiDoc — Più espressivo di Markdown, con supporto nativo per ammonizioni, riferimenti incrociati e indici.
- reStructuredText (rST) — Lo standard per la documentazione Python (Sphinx).
- LaTeX — Lo standard d'oro per articoli accademici e notazione matematica.
- Editor rich text — Google Docs, la modalità WYSIWYG di Notion e Word restano la scelta giusta quando il pubblico non vuole vedere alcuna sintassi.
Per approfondire
Per praticare Markdown con anteprima in tempo reale, prova lo strumento Anteprima Markdown. Per un'introduzione pratica alla sintassi, consulta il tutorial Scrivere in Markdown. Entrambi sono gratuiti e funzionano direttamente nel tuo browser.