📄
← Torna alle guide

Guida alla sintassi Markdown: riferimento completo con esempi

· Tag: markdown-syntax, markdown-guide, markdown-formatting, github-flavored-markdown, markdown-reference

Guida alla sintassi Markdown

Markdown è un linguaggio di markup leggero che converte testo semplice in HTML formattato. Creato da John Gruber nel 2004, è diventato il formato di scrittura standard per la documentazione, i file README e i contenuti tecnici in tutto il web.

Titoli

Usa i simboli #. Un # per il livello più alto, fino a sei per il più profondo:

# Heading 1
## Heading 2
### Heading 3
#### Heading 4

I livelli dovrebbero aumentare di uno — saltare da ## a #### può confondere gli screen reader.

Formattazione del testo

**Bold text** or __Bold text__
*Italic text* or _Italic text_
**_Bold and italic_**
~~Strikethrough text~~

Link

[Link text](https://example.com)
[Link with title](https://example.com "Title")
[Reference-style][ref-id]
[ref-id]: https://example.com
<contact@example.com>

Immagini

![Alt text](/path/to/image.jpg)
[![Alt text](/path/to/image.jpg)](https://example.com)

Il testo alternativo è fondamentale per l'accessibilità e la SEO — viene visualizzato quando le immagini non riescono a caricarsi.

Elenchi

Gli elenchi non ordinati usano -, * o +. Gli elenchi ordinati usano i numeri:

- Item one         1. First item
- Item two         2. Second item
  - Nested item       1. Nested item

Codice

Il codice inline usa i backtick singoli: `printf()`.

I blocchi di codice usano i tripli backtick con un identificatore di linguaggio opzionale:

```python
def greet(name):
    return f"Hello, {name}!"


Linguaggi supportati: `javascript`, `python`, `html`, `css`, `json`, `bash`, `sql`, `yaml`.

## Citazioni a blocchi

```markdown
> This is a blockquote.
> > Nested blockquotes are supported.

Comuni per callout, note e citazioni di fonti esterne.

Righe orizzontali

Tre o più trattini, asterischi o underscore su una riga:

---
***
___

Tabelle

Barre verticali e trattini definiscono le colonne. I due punti controllano l'allineamento:

| Left | Center | Right |
| :--- | :----: | ----: |
| A1   | B1     | C1    |

Estensioni GitHub Flavored Markdown

GitHub Flavored Markdown (GFM) aggiunge funzionalità utili:

- [x] Completed task     # Task lists
- [ ] Incomplete task

:smile: :rocket: :warning:    # Emoji shortcodes

~~Strikethrough text~~        # Strikethrough

GFM crea anche link automatici per gli URL — www.example.com diventa cliccabile senza racchiuderlo in < >.

Escape dei caratteri speciali

Prefissa con \ per visualizzare i caratteri letterali di Markdown:

\*This is not italic\*
\# This is not a heading

Caratteri che richiedono l'escaping: \ ` * _ { } [ ] ( ) # + - . ! | ~.

Anteprima Markdown online

Usa lo strumento di anteprima Markdown per scrivere e visualizzare Markdown in tempo reale. L'anteprima live si aggiorna mentre digiti, mostrando esattamente come verranno renderizzati titoli, link, immagini, blocchi di codice e tabelle.

Guida alla sintassi Markdown: riferimento completo con esempi - CoolTool