L'AgID (Agenzia per l'Italia Digitale) raccomanda alle pubbliche amministrazioni italiane di pubblicare documentazione tecnica in formati testuali semplici e accessibili — e Markdown, proprio perché resta leggibile anche senza rendering, viene spesso citato come alternativa preferibile a formati proprietari chiusi come i file di Word.
Sintassi di base
# Titolo— titoli di diversi livelli in base al numero di caratteri#.**grassetto**e*corsivo*— enfasi del testo.[testo](url)— un link.- elementoo1. elemento— elenchi puntati e numerati.- ``` — blocchi di codice con evidenziazione della sintassi in base al nome del linguaggio.
Perché la pubblica amministrazione italiana guarda al testo semplice
Le linee guida di design per i servizi digitali della PA italiana insistono sull'accessibilità dei contenuti: un file leggibile riga per riga, senza bisogno di software proprietario per aprirlo, è più facile da verificare, archiviare a lungo termine e rendere accessibile con tecnologie assistive rispetto a un documento binario. Markdown si presta bene a questo obiettivo proprio perché la sua sintassi minimale non nasconde mai il contenuto dietro la formattazione.
Il Markdown originale non definiva tabelle né esisteva CommonMark
Il Markdown pubblicato da John Gruber nel 2004 era una descrizione in prosa, non una grammatica formale, e non prevedeva tabelle, testo barrato né blocchi di codice con linguaggio evidenziato. Per un decennio ogni implementazione ha interpretato a modo suo le zone d'ombra del testo originale, finché nel 2014 CommonMark ha fissato una grammatica precisa — e GitHub Flavored Markdown (GFM) vi ha aggiunto sopra le tabelle e le liste di attività che oggi sembrano scontate in qualsiasi README.
Conversione in HTML e viceversa
La conversione Markdown → HTML è diretta: un parser riconosce i costrutti sintattici e genera i tag corrispondenti. La conversione inversa, HTML → Markdown, è più complessa, poiché HTML supporta molte più opzioni di formattazione del Markdown di base, quindi parte del markup (tabelle complesse, stili annidati) può essere semplificata o persa.
A cosa serve
- Vedere rapidamente l'anteprima di come verrà renderizzato un file Markdown, senza pubblicarlo.
- Convertire il contenuto di una pagina o di un documento in Markdown per salvarlo in un sistema di controllo versione.
- Preparare contenuti HTML da inserire in un'app che accetta solo Markdown.