Markdown è un modo semplice per formattare il testo usando caratteri semplici. È usato ovunque — GitHub, Reddit, Notion, Discord, documentazione tecnica e innumerevoli altre piattaforme. Invece di cliccare pulsanti per rendere il testo in grassetto o creare titoli, digiti simboli semplici. Questo tutorial ti insegna le basi e ti permette di fare pratica usando il nostro strumento gratuito Anteprima Markdown.
Cosa ti serve
- Un browser web (Chrome, Firefox, Safari o Edge)
- Nessun account né installazione necessari
- Circa 10 minuti per imparare le basi
Guida passo dopo passo
Apri lo strumento Anteprima Markdown
Vai allo strumento Anteprima Markdown. Vedrai un editor a schermo diviso: il lato sinistro è dove scrivi il Markdown, e il lato destro mostra l'anteprima formattata in tempo reale. Ogni modifica che digiti appare istantaneamente nell'anteprima.
Impara la sintassi base
Inizia a digitare nell'editor per sperimentare con la formattazione Markdown. La sintassi base è semplice e può essere imparata in pochi minuti. Fai pratica con gli esempi qui sotto — digitali sul lato sinistro e osserva il risultato formattato apparire sulla destra.
Scrivi il tuo documento
Ora scrivi il tuo contenuto effettivo. Usa i titoli per strutturare il documento, gli elenchi per organizzare le informazioni, e il testo in grassetto o corsivo per enfatizzare. L'anteprima in tempo reale ti assicura di sapere sempre come apparirà il risultato finale mentre digiti.
Esporta o copia il risultato
Una volta che il documento ha l'aspetto desiderato, copia il testo Markdown per usarlo su qualsiasi piattaforma che lo supporti, oppure esporta il risultato formattato. Il tuo contenuto Markdown può essere incollato in GitHub, Reddit, Notion o qualsiasi editor compatibile con Markdown.
Buono a sapersi Markdown è stato progettato per essere leggibile anche senza rendering. Un documento Markdown ha un aspetto pulito e strutturato come testo semplice, ed è una delle ragioni per cui è diventato così popolare.
Sintassi Markdown essenziale
Titoli
Usa i simboli # per creare titoli. Più simboli # significano titoli più piccoli:
# Titolo 1 (il più grande)
## Titolo 2
### Titolo 3
#### Titolo 4
Testo in grassetto e corsivo
Racchiudi il testo tra asterischi per enfatizzarlo:
**Questo è testo in grassetto**
*Questo è testo in corsivo*
***Questo è grassetto e corsivo***
Elenchi
Crea elenchi non ordinati con trattini ed elenchi ordinati con numeri:
- Primo elemento
- Secondo elemento
- Terzo elemento
1. Primo passo
2. Secondo passo
3. Terzo passo
Link
Crea link cliccabili usando parentesi quadre e tonde:
[Testo del link](https://example.com)
Codice
Usa i backtick per il codice inline e i tripli backtick per i blocchi di codice:
Inline: `console.log("hello")`
Blocco di codice:
```javascript
function greet(name) {
return "Hello, " + name;
}
```
Consiglio Non devi memorizzare tutto subito. Inizia con titoli, grassetto ed elenchi — questi tre coprono l'80% della scrittura tipica in Markdown. Aggiungi altra sintassi quando ne hai bisogno.
Immagini
Aggiungi immagini con un punto esclamativo prima della sintassi del link:
Citazioni
Usa > per creare testo citato:
> Questa è una citazione.
> Può estendersi su più righe.
Dove si usa Markdown
| Piattaforma | Come viene usato Markdown |
|---|---|
| GitHub | File README, issue, pull request, commenti |
| Formattazione di post e commenti | |
| Notion | Contenuti delle pagine e documentazione |
| Discord | Formattazione dei messaggi |
| Stack Overflow | Domande, risposte e commenti |
| Generatori di siti statici | Post del blog e contenuti delle pagine |
Importante Piattaforme diverse supportano funzionalità Markdown leggermente diverse. Le basi (titoli, grassetto, corsivo, elenchi, link) funzionano ovunque. Funzionalità avanzate come tabelle o note a piè di pagina variano da piattaforma a piattaforma. Visualizza sempre l'anteprima prima di pubblicare su una nuova piattaforma.
Domande frequenti
Qual è la differenza tra Markdown e HTML? Markdown viene convertito in HTML dietro le quinte. È un modo più semplice per scrivere testo formattato senza dover ricordare i tag HTML. Ovunque accetti Markdown, verrà renderizzato come HTML.
Posso usare Markdown per documenti professionali? Assolutamente. Molti team usano Markdown per documentazione, proposte e report. Esistono strumenti per convertire Markdown in PDF, Word e formati di presentazione.
La sintassi è la stessa ovunque? La sintassi base è universale. Alcune piattaforme aggiungono estensioni (come GitHub Flavored Markdown che aggiunge tabelle e liste di attività). Le basi trattate in questo tutorial funzionano ovunque.
Prossimi passi
Ora che conosci Markdown, prova a scrivere un README per un progetto, formattare un post del blog o creare documentazione tecnica. Per attività di formattazione più avanzate, esplora il nostro Formattatore JSON per la documentazione del codice o l'Editor PDF per l'output finale dei documenti.