Cos'è il Markdown?

Markdown è un linguaggio di markup leggero creato da John Gruber nel 2004 che consente di scrivere testo formattato usando la sintassi del testo normale. È stato progettato per essere leggibile anche nella sua forma grezza — asterischi per l'enfasi, simboli cancelletto per le intestazioni, trattini per gli elenchi. Markdown è ampiamente usato nella documentazione (README di GitHub), nelle app per la presa di appunti (Obsidian, Notion), nelle piattaforme di blogging e nella comunicazione degli sviluppatori.

Questo strumento fornisce un'anteprima dal vivo del Markdown mentre si digita. Il pannello sinistro mostra il sorgente Markdown grezzo e il pannello destro renderizza l'output formattato in tempo reale. Supporta Markdown standard, le estensioni GitHub-Flavored Markdown (GFM) (tabelle, elenchi di attività, testo barrato, blocchi di codice delimitati) e l'evidenziazione della sintassi per i blocchi di codice.

Sintassi Markdown di base

• Intestazioni: usare # per H1, ## per H2, ### per H3, e così via fino a ###### per H6.
• Grassetto: racchiudere il testo in doppi asterischi o doppi underscore. Corsivo: usare asterischi singoli o underscore.
• Elenchi: iniziare le righe con - o * per i punti elenco, o 1. per gli elenchi numerati. Annidare con l'indentazione.
• Link: [testo del link](URL). Immagini: .
• Codice: usare il backtick per il codice inline, tre backtick per i blocchi di codice delimitati con linguaggio opzionale per l'evidenziazione della sintassi.

Come usare questo strumento

Digitare o incollare Markdown nell'editor. L'anteprima si aggiorna in tempo reale. È possibile passare tra le modalità affiancata e solo anteprima. Lo strumento supporta la copia negli appunti (sia il sorgente Markdown che l'HTML renderizzato), il download come file .md e l'esportazione in HTML.

GitHub Flavored Markdown

GitHub Flavored Markdown estende il Markdown standard con tabelle (colonne separate da pipe), elenchi di attività (caselle di controllo con - [ ] e - [x]), testo barrato (racchiuso in doppi tilde), URL con link automatici e blocchi di codice delimitati con evidenziazione della sintassi. Questo strumento supporta tutte le funzionalità GFM, rendendolo ideale per visualizzare in anteprima i file README e la documentazione prima di eseguire il push su GitHub.

Domande frequenti

Posso usare HTML all'interno del Markdown?

Sì. Il Markdown standard consente HTML inline per tutto ciò che la sintassi Markdown non riesce a esprimere (come tabelle complesse, testo colorato o video incorporati). Tuttavia, alcuni renderer Markdown (come GitHub) eliminano certi tag HTML per motivi di sicurezza. Questo strumento di anteprima renderizza la maggior parte dei tag HTML per mostrare l'output previsto.

Qual è la differenza tra Markdown e il testo ricco?

Il testo ricco (come i documenti Word) memorizza la formattazione come codici nascosti all'interno del file. Markdown memorizza la formattazione come caratteri di testo visibili — **grassetto** è letteralmente digitato con asterischi. Questo rende i file Markdown portabili (qualsiasi editor di testo può leggerli), compatibili con il controllo di versione (le differenze sono pulite) e a prova di futuro (nessun formato proprietario di cui preoccuparsi).