Menu

Editor Markdown

Scrivi in Markdown con anteprima affiancata dal vivo.

Di Nethanel Bar, Co-founder & CEO

Ultimo aggiornamento

Vuoi imparare a programmare sul serio?

Coddy ti insegna facendoti scrivere codice vero nel browser: lezioni interattive, feedback immediato e aiuto dall'AI quando ti blocchi.

Che cos'è un editor Markdown?

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.

ElementoMarkdownRisultato
Titolo 1# TitoloTitolo di primo livello
Titolo 2## SezioneTitolo di sezione
Grassetto**forte****forte**
Corsivo*enfasi* o _enfasi_*enfasi*
Codice in linea`code`code
Blocco di codiceRacchiudi il codice tra tre backtick, con un'indicazione del linguaggio facoltativaBlocco con evidenziazione della sintassi
Link[testo](https://example.com)Link cliccabile
Immagine![alt](url)Immagine incorporata
Lista- elementoElenco puntato
Lista numerata1. elementoElenco ordinato
Lista di attività (GFM)- [x] fattoCasella spuntata
Tabella (GFM)| a | b |\n|---|---|\n| 1 | 2 |Tabella a due colonne
Citazione> citazioneCitazione rientrata

Esempi di Markdown da provare

L'apertura tipica di un README

Sorgente
# Project Name
A 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.

Tabelle (GitHub-flavored)

Sorgente
| Feature | Free | Pro ||---------|:----:|:---:|| Editor  |  ✓   |  ✓  || Export  |      |  ✓  |

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.

Lista di attività

Sorgente
- [x] Draft the post- [x] Add screenshots- [ ] Publish

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.

Scopri di più

Altri strumenti per sviluppatori

Illustrazione dei linguaggi di programmazione di Coddy

Impara a programmare con Coddy

INIZIA