Guida alla Sintassi Markdown: Dalle Basi all'Avanzato

Markdown è il formato di scrittura che gli sviluppatori apprezzano davvero. Niente clic attraverso menu di formattazione, niente lotte con editor WYSIWYG — solo testo semplice con pochi simboli che si converte in HTML pulito. File README, documentazione, articoli di blog, messaggi di chat e persino questo articolo sono scritti in Markdown.

Visualizza il tuo Markdown in tempo reale con il nostro Markdown Previewer — scrivi da un lato, vedi l'output formattato dall'altro.

Sintassi di Base

Intestazioni

# Intestazione 1
## Intestazione 2
### Intestazione 3
#### Intestazione 4

Usa le intestazioni in modo gerarchico. Non saltare livelli (passando da H1 a H3) — danneggia sia la leggibilità che l'accessibilità.

Enfasi

*corsivo* o _corsivo_
**grassetto** o __grassetto__
***grassetto corsivo***
~~barrato~~

Link e Immagini

[Testo del link](https://example.com)
[Link con titolo](https://example.com "Titolo")
![Testo alternativo](image.png)

Liste

- Elemento non ordinato
- Altro elemento
  - Elemento annidato

1. Primo elemento
2. Secondo elemento
3. Terzo elemento

Citazioni

> Questa è una citazione.
> Può estendersi su più righe.

Codice

Codice Inline

Usa i backtick per il codice inline: `const x = 42`

Blocchi di Codice

Tripli backtick con un identificatore di linguaggio opzionale:

```javascript
function greet(name) {
  return `Hello, ${name}!`;
}
```

I linguaggi supportati includono javascript, python, json, yaml, html, css, bash e molti altri.

Tabelle

| Intestazione 1 | Intestazione 2 | Intestazione 3 |
|----------|----------|----------|
| Cella 1   | Cella 2   | Cella 3   |
| Cella 4   | Cella 5   | Cella 6   |

Allineamento:

| Sinistra | Centro | Destra |
|:-----|:------:|------:|
| S    |   C    |     D |

Sintassi Avanzata

Liste di Attività

- [x] Attività completata
- [ ] Attività in sospeso
- [ ] Altra attività

Note a Piè di Pagina

Ecco un'affermazione[^1].

[^1]: Questo è il contenuto della nota a piè di pagina.

Liste di Definizioni

Termine
: Definizione del termine

Linee Orizzontali

---
***
___

GitHub-Flavored Markdown (GFM)

GitHub estende il Markdown standard con funzionalità utili:

• URL auto-linkati — Gli URL nudi diventano cliccabili
• Liste di attività — Checkbox in issue e PR
• Tabelle — La sintassi con pipe mostrata sopra
• Barrato — ~~testo cancellato~~
• Evidenziazione sintassi — Colorazione del codice specifica per linguaggio
• Emoji — :smile: diventa una faccina sorridente

Consigli di Scrittura

• Mantieni i paragrafi brevi — massimo 3-5 frasi
• Usa le intestazioni per creare una struttura facilmente scansionabile
• Preferisci le liste ai paragrafi lunghi per passaggi o funzionalità
• Aggiungi esempi di codice ogni volta che discuti concetti tecnici
• Visualizza regolarmente — il nostro Markdown Previewer mostra l'output mentre digiti

Domande Frequenti

Qual è la differenza tra Markdown e HTML?

Markdown è un formato di scrittura semplificato che si converte in HTML. Copre le esigenze di formattazione più comuni con molta meno sintassi. Puoi incorporare HTML raw in Markdown quando hai bisogno di funzionalità che Markdown non supporta.

Quale versione di Markdown dovrei usare?

GitHub-Flavored Markdown (GFM) è la più ampiamente supportata. Aggiunge tabelle, liste di attività e barrato al Markdown standard. CommonMark è la specifica standardizzata.

Posso usare Markdown per la documentazione?

Assolutamente. Markdown è lo standard per file README, wiki e siti di documentazione. Strumenti come MkDocs, Docusaurus e GitBook usano tutti Markdown.

Risorse Correlate

• Markdown vs Rich Text — perché gli sviluppatori preferiscono il testo semplice
• Text Diff Checker — confronta file Markdown
• Markdown Previewer — visualizza Markdown in tempo reale
• Text Diff Checker Tool — confronta testo e file Markdown