Markdown: guida per principianti

Cos'è il markdown

Markdown è un linguaggio di markup leggero: un insieme di convenzioni di testo semplice che un programma trasforma in output formattato, di solito HTML. Il punto è che il testo grezzo resta leggibile — un titolo marcato con # o una lista con trattini appare strutturato ancor prima di essere renderizzato. Ottieni la chiarezza della formattazione senza uscire da un file di testo né toccare il mouse, per questo scrittori e sviluppatori l'hanno adottato così in fretta.

La sintassi base

L'essenziale sta in poche righe. Un # crea un titolo, e più cancelletti fanno sottotitoli più piccoli. Due asterischi attorno a un testo lo mettono in **grassetto**, uno in *corsivo*. Le righe che iniziano con - o * diventano punti elenco, e quelle che iniziano con 1. una lista numerata. I link sono [testo visibile](l-url), e un'immagine uguale con un ! davanti. I backtick marcano il `codice`. Padroneggia questo e formatti quasi tutto.

Perché è ovunque

Markdown si è diffuso perché è portabile e a prova di futuro. È solo testo, quindi si apre in qualsiasi editor, si copia pulito tra le app e resterà leggibile tra decenni. GitHub lo usa per README e issue, Reddit e i forum per i post, app di chat come Slack e Discord per la formattazione dei messaggi, e strumenti per note e generatori di siti statici per interi documenti. Imparalo una volta e la stessa manciata di simboli funziona su tutti.

Trucchi e varianti

Un paio di cose confondono i principianti. Le righe vuote contano: i paragrafi hanno bisogno di una riga vuota tra loro, e una lista spesso ne serve una prima per renderizzare. E markdown non è un unico standard — esiste in 'varianti'. Le funzioni base funzionano ovunque, ma extra come tabelle, liste di attività e barrato sono estensioni che alcuni strumenti supportano e altri no. Nel dubbio, il Markdown di GitHub e la specifica CommonMark sono i due riferimenti più sicuri.

Domande frequenti

Cos'è il Markdown?

Una sintassi di formattazione in testo semplice che si converte in HTML con simboli semplici come # e **.

Come metto il testo in grassetto in Markdown?

Racchiudilo in doppi asterischi: **così**.

Dove si usa Markdown?

GitHub, app di chat, strumenti per note, forum e generatori di siti statici, tra molti altri.