Guida rapida Markdown — Sintassi con anteprima dal vivo

Da uno a sei # seguiti da uno spazio. Usa un solo titolo # per documento e non saltare livelli: screen reader e indici si basano sull'ordine.

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

Il vecchio stile "setext"; solo livelli 1 e 2. Una riga di --- sotto un paragrafo lo trasforma in titolo, cosa che sorprende chi si aspetta una linea orizzontale: lascia una riga vuota prima di ---.

Heading 1
=========

Heading 2
---------

Una riga vuota separa i paragrafi. Un singolo a capo dentro un paragrafo viene unito in una sola riga (salvo le eccezioni indicate sotto “A capo”).

First paragraph, which can wrap
across several source lines.

Second paragraph after a blank line.

Per andare a capo senza un nuovo paragrafo, termina la riga con due spazi o una barra rovesciata. I commenti di GitHub, Obsidian (per impostazione predefinita), Slack e Discord invece trattano ogni nuova riga come un a capo.

Two trailing spaces  
make a break.
A trailing backslash\
works too.<br>So does an HTML br.

Gli asterischi funzionano anche dentro le parole, i trattini bassi no (i nomi_in_snake_case restano letterali): per questo quasi tutte le guide di stile preferiscono *.

**bold** or __bold__

*italic* or _italic_

***bold italic***

in**side**word works with *, not with _

Inizia ogni riga con >. Le citazioni possono contenere qualsiasi altro Markdown, inclusi elenchi e codice.

> Quoted text.
> Still quoted.
>
> > Nested quote.

-, * e + funzionano tutti; non mescolarli nello stesso elenco (un marcatore diverso avvia un nuovo elenco).

- Item
- Item
  - Nested (indent 2 spaces)
- Item

Il primo numero stabilisce l'inizio; i numeri successivi vengono ignorati, quindi con "1." su ogni riga la numerazione si aggiorna da sola quando riordini le voci.

1. First
1. Second
1. Third

3. Starts at three
4. Four

Indenta il contenuto aggiuntivo allineandolo al primo carattere del testo della voce (3 spazi dopo "1. ").

1. Install:

   ```sh
   npm install marked
   ```

2. Indent continuation lines
   to the item text.

Il Markdown tra backtick non viene interpretato.

Run `npm test` now.

Use ``double `backticks` `` when the code contains one.

Tre backtick (o ~~~) su righe proprie. La parola dopo l'apertura indica il linguaggio per l'evidenziazione della sintassi su GitHub, GitLab, Obsidian e Discord.

```js
const answer = 42;
console.log(answer);
```

const answer = 42;
console.log(answer);

La sintassi originale. I blocchi delimitati sono più chiari e consentono di indicare il linguaggio; il codice indentato è l'unica forma che il vecchio Reddit capisce.

Paragraph.

    four spaces of indent
    make a code block

four spaces of indent
make a code block

Tre o più -, * o _ su una riga a sé, con una riga vuota sopra.

Above

---

Below (also *** or ___)

La forma con parentesi angolari è l'autolink di CommonMark. Gli spazi in un URL vanno scritti %20, oppure l'URL va racchiuso in <…>.

[Link text](https://freetoolsforweb.com)

[With a title](https://freetoolsforweb.com "Hover text")

[Relative link](/tools/regex-cheat-sheet)

<https://example.com>

Tiene gli URL lunghi fuori dal testo. Le definizioni possono stare in qualsiasi punto del documento e non vengono visualizzate.

Read the [spec][cm] and the [GFM spec].

[cm]: https://spec.commonmark.org/
[GFM spec]: https://github.github.com/gfm/

Su GitHub e GitLab ogni titolo riceve un id automatico: minuscolo, spazi trasformati in trattini, punteggiatura rimossa ("## Install & Run" diventa #install--run). Obsidian usa invece [[#Titolo]].

[Jump to tables](#md-tables)

Come un link con ! davanti. Il testo tra [ ] è il testo alternativo: descrivi l'immagine per chi non può vederla. Markdown non ha una sintassi per le dimensioni; usa l'HTML <img width="200"> dove l'HTML è consentito.

![Site logo](/brand/favicon.svg "Optional title")

[![Clickable image](/brand/favicon.svg)](/tools)

Una barra rovesciata rende letterale qualsiasi segno di punteggiatura ASCII: \ ` * _ { } [ ] ( ) # + - . ! |

\*not italic\*  \# not a heading  1\. not a list

Consentito da CommonMark. GitHub e GitLab mantengono un sottoinsieme sicuro (niente script, style o gestori di eventi); Slack, Discord, Reddit e Notion lo mostrano come testo.

Press <kbd>Ctrl</kbd> + <kbd>C</kbd>, H<sub>2</sub>O, x<sup>2</sup>.

Un commento HTML resta nel sorgente ma non viene visualizzato ovunque l'HTML sia consentito.

Visible.

<!-- Not rendered: notes for editors -->

Also visible.

La seconda riga è obbligatoria; i due punti impostano l'allineamento. Le colonne non devono essere allineate nel sorgente. Scrivi una barra verticale letterale come \|. Niente celle unite né celle su più righe (su GitHub usa <br> dentro una cella).

Dove: GFM, GitLab, Obsidian, Reddit; Notion quando incolli

| Left | Centre | Right |
| :--- | :----: | ----: |
| a    |   b    |     1 |
| `c`  | **d**  |    22 |

Su GitHub e GitLab le caselle sono cliccabili in issue e pull request e aggiornano il sorgente.

Dove: GFM, GitLab, Obsidian; Notion con la scorciatoia []

- [x] Write the draft
- [ ] Review
- [ ] Publish

Due tilde ovunque; GitHub ne accetta anche una. Slack usa ~una sola~ tilde, Jira i -trattini-.

Dove: GFM, GitLab, Obsidian, Discord, Reddit, Notion

~~no longer true~~

GFM trasforma in link gli URL semplici e gli indirizzi www. In CommonMark puro restano testo, a meno che non siano racchiusi in <…>.

Dove: GFM, GitLab, Obsidian, Slack, Discord, Reddit

Visit https://freetoolsforweb.com or www.example.com.

La definizione può stare ovunque; le note sono numerate in ordine di richiamo ed elencate alla fine. Obsidian ha anche note in linea: ^[così].

Dove: GFM, GitLab, Obsidian (non CommonMark)

Markdown was created in 2004.[^1]

[^1]: By John Gruber, with Aaron Swartz.

Imposti tu l'ancora. Supportati da Pandoc, PHP Markdown Extra, Hugo, Jekyll (kramdown), MkDocs e Docusaurus; GitHub e GitLab li ignorano e mostrano le graffe, usando gli id automatici.

Dove: Pandoc, Hugo, Jekyll, MkDocs, Docusaurus; non GitHub né GitLab

### Install {#setup}

Nomi racchiusi tra due punti. Digitare i due punti su GitHub, Slack, Discord o Notion apre un selettore di emoji. Incollare l'emoji stessa funziona ovunque.

Dove: GitHub, GitLab, Slack, Discord; non Obsidian (senza plugin) né CommonMark

Ship it :rocket: :+1: :tada:

TeX tra segni $ in linea, $$ per un blocco a sé. GitHub accetta anche $`…`$ e un blocco ```math; GitLab supporta le stesse forme. Notion usa $$…$$ per le equazioni in linea.

Dove: GitHub, GitLab, Obsidian, Notion (sintassi propria)

Inline: $E = mc^2$

$$
\sum_{i=1}^{n} i = \frac{n(n+1)}{2}
$$

Un blocco di codice con linguaggio mermaid diventa un diagramma: diagrammi di flusso, di sequenza, delle classi, degli stati, di Gantt ed ER.

Dove: GitHub, GitLab, Obsidian, Notion (blocco di codice Mermaid)

```mermaid
flowchart LR
  A[Write] --> B{Review}
  B -->|ok| C[Publish]
  B -->|changes| A
```

GitHub ha cinque tipi: NOTE, TIP, IMPORTANT, WARNING, CAUTION. GitLab (17.10+) accetta la stessa sintassi. Obsidian ha molti più tipi, titoli personalizzati (> [!tip] Titolo) e la compressione (> [!faq]-).

Dove: GitHub, GitLab 17.10+, Obsidian; altrove una citazione normale

> [!NOTE]
> Useful information.

> [!WARNING]
> Critical content that needs attention.

È HTML, ma ampiamente supportato. Lascia righe vuote attorno al Markdown interno, altrimenti non viene interpretato.

Dove: GitHub, GitLab, Obsidian, gran parte dei generatori di siti statici

<details>
<summary>Click to expand</summary>

Hidden **Markdown** content.

</details>

Obsidian e alcuni editor (Typora, iA Writer); GitHub mostra i segni di uguale. Usa <mark> dove l'HTML è consentito.

Dove: Obsidian, Typora; non GitHub

This is ==highlighted== text.