Un editor Markdown è un ambiente di scrittura a due colonne: da un lato digiti Markdown in testo semplice, dall'altro l'anteprima renderizzata si aggiorna in tempo reale. È il formato dietro i README di GitHub, i portali di documentazione, i generatori di siti statici, le piattaforme di blog, app di note come Obsidian e strumenti di chat come Discord e Slack.
Il bello di Markdown è proprio questo: si legge bene come testo semplice e diventa HTML strutturato quando viene renderizzato. Perdi meno tempo con le barre di formattazione e ne dedichi di più alla scrittura, ed è esattamente per questo che technical writer e sviluppatori lo preferiscono.
La maggior parte degli editor moderni supporta *GitHub-Flavored Markdown* (GFM), che aggiunge tabelle, liste di attività, blocchi di codice con indicazione del linguaggio, link automatici e testo barrato alla specifica originale CommonMark.
Cosa impari usando un editor Markdown
Markdown è testo semplice: leggibile nel tuo editor *e* renderizzabile come HTML, senza barre degli strumenti né formattazione nascosta.
Titoli, liste, link ed enfasi coprono il 90% di ciò che scriverai. Tabelle e blocchi di codice coprono quasi tutto il restante 10%.
I blocchi di codice con indicazione del linguaggio (```js, ```python) attivano l'evidenziazione della sintassi in molti renderer.
Markdown viene convertito in HTML al momento del rendering. Lo stesso sorgente produce lo stesso risultato ovunque si usi un renderer CommonMark/GFM.
Come usare un editor Markdown passo dopo passo
1
Inizia a scrivere nel pannello di sinistra
Usa # per i titoli, * o _ per l'enfasi e - per le liste. Il pannello di destra si aggiorna mentre scrivi.
2
Dai una struttura
Aggiungi titoli, blocchi di codice e tabelle per organizzare il documento. Quasi tutti gli editor hanno scorciatoie da tastiera (Ctrl+B, Ctrl+I) per la formattazione più comune.
3
Controlla l'anteprima dell'HTML
Confronta l'anteprima con il sorgente. Se qualcosa non viene visualizzato come ti aspetti, di solito manca una riga vuota o un blocco di codice non è chiuso bene.
4
Copia o scarica
Copia il sorgente Markdown nel tuo README, oppure copia l'HTML per incollarlo in un'email, in un CMS o in qualsiasi posto che non capisce Markdown.
Guida rapida alla sintassi Markdown
L'80% di Markdown che userai ogni giorno. Tutto il resto è a una ricerca di distanza. Specifiche: CommonMark e GitHub-Flavored Markdown.
Elemento
Markdown
Risultato
Titolo 1
# Titolo
Titolo di primo livello
Titolo 2
## Sezione
Titolo di sezione
Grassetto
**forte**
**forte**
Corsivo
*enfasi* o _enfasi_
*enfasi*
Codice in linea
`code`
code
Blocco di codice
Racchiudi il codice tra tre backtick, con un'indicazione del linguaggio facoltativa
Blocco con evidenziazione della sintassi
Link
[testo](https://example.com)
Link cliccabile
Immagine

Immagine incorporata
Lista
- elemento
Elenco puntato
Lista numerata
1. elemento
Elenco ordinato
Lista di attività (GFM)
- [x] fatto
Casella spuntata
Tabella (GFM)
| a | b |\n|---|---|\n| 1 | 2 |
Tabella a due colonne
Citazione
> citazione
Citazione rientrata
Esempi di Markdown da provare
L'apertura tipica di un README
Sorgente
# Project NameA short description in one or two sentences.## Install```bashnpm install project-name```## Quick start- Step 1- Step 2- Step 3
Titolo, paragrafo, comando di installazione in un blocco di codice e un elenco puntato: è la spina dorsale di ogni buon README.
Le barre verticali (|) separano le colonne. La riga di trattini definisce le colonne e i caratteri : impostano l'allineamento (sinistra, centro, destra). Le tabelle GFM non richiedono larghezze precise: conta solo la struttura.
GitHub le mostra come caselle interattive dentro issue e pull request. Utili per checklist nel documento stesso e per seguire progetti in modo leggero.
Errori comuni con Markdown
Dimenticare le righe vuote intorno a liste, tabelle e blocchi di codice. La maggior parte dei renderer ha bisogno di una riga vuota per iniziare un nuovo blocco.
Mescolare tabulazioni e spazi dentro una lista: alcuni renderer rompono il rientro senza avvisare.
Mettere HTML grezzo dentro un blocco di codice e aspettarsi che venga renderizzato. I blocchi di codice sono *letterali*: è proprio il loro scopo.
Dare per scontato che tutto il Markdown sia uguale. CommonMark, GFM e le varie varianti differiscono in modo sottile (a capo, link automatici, HTML incorporato).
Usare > per il rientro invece che per le citazioni. > *significa* citazione: scegli un altro modo per rientrare il testo.
Domande frequenti sull'editor Markdown
Che cos'è Markdown?
Markdown è un linguaggio di markup leggero che converte una sintassi semplice in testo normale (# titolo, **grassetto**, [link](url)) in HTML formattato. È pensato per essere leggibile anche nella forma sorgente.
Come converto Markdown in HTML?
Incolla il tuo Markdown in un editor Markdown e copia l'HTML renderizzato, oppure usa un convertitore come marked, markdown-it o pandoc. La maggior parte dei generatori di siti statici lo fa automaticamente in fase di build.
Qual è la differenza tra Markdown e GitHub-Flavored Markdown?
GitHub-Flavored Markdown (GFM) aggiunge tabelle, blocchi di codice con indicazione del linguaggio, liste di attività, link automatici e testo barrato al Markdown standard. È il dialetto usato da GitHub, GitLab e molte piattaforme di documentazione.
Posso usare HTML dentro Markdown?
Sì, la maggior parte dei renderer lascia passare l'HTML grezzo. È utile per incorporare cose che Markdown non supporta nativamente (layout personalizzati, tag video), ma lega il documento a un output HTML.
L'editor Markdown è privato?
Sì. L'editor di Coddy renderizza Markdown interamente nel tuo browser: il testo non viene caricato da nessuna parte.