Il Markdown in una pagina.Cosa scrivi, cosa ottieni.

Titoli, testo e a capo

Una riga vuota inizia un nuovo paragrafo. Un solo a capo dentro un paragrafo viene ignorato e le righe si uniscono. Per forzare un a capo, termina la riga con due spazi o una barra rovesciata.

Elenchi, liste di attività e tabelle

- Milk
- Bread
  - Rye
  - Wheat

1. Open the folder
2. Pick a file

- [x] Write the plan
- [ ] Review it

Un elenco puntato inizia ogni riga con -, * o +. Rientra di due o quattro spazi per annidare. In un elenco numerato basta che sia giusto il primo numero. Una lista di attività è un elenco puntato con [ ] o [x] davanti, e appare come caselle da spuntare.

| Plan  | Price | Users |
|-------|------:|:-----:|
| Free  |    $0 |   1   |
| Team  |   $12 |  10   |

In una tabella, la seconda riga separa l’intestazione dalle righe. :--- allinea una colonna a sinistra, ---: a destra e :---: al centro. Le colonne non devono essere allineate nel testo. Per mettere un | dentro una cella, scrivi \|.

Codice

Racchiudi il codice in linea tra singoli apici inversi. Per un blocco, metti tre apici inversi sulla riga prima e su quella dopo, e scrivi il linguaggio dopo i primi per avere i colori della sintassi:

```swift
let greeting = "Hello"
```

Un blocco contrassegnato diff colora le righe che iniziano con + e -. Un blocco contrassegnato mermaid diventa un diagramma.

Link e immagini

[DotMD](https://getdotmd.com)
![A cat on a keyboard](assets/cat.png)
[the plan](plan.md)
[setup](#setup)

Un link ha il testo tra parentesi quadre e l’indirizzo tra tonde. Anche un indirizzo web da solo diventa un link. Un’immagine è un link con un ! davanti; il suo testo la descrive per gli screen reader. I percorsi sono relativi al documento, e un link può puntare a un altro file .md o a un titolo, la cui àncora è il suo testo in minuscolo con gli spazi trasformati in -.

Per indirizzi lunghi o ripetuti, mettili in fondo e richiamali con un nome breve: [guida][1], poi [1]: https://example.com/guide su una riga a sé.

Callout, commenti e front matter

> [!NOTE]
> Useful information that users should know.

Una citazione la cui prima riga è [!NOTE], [!TIP], [!IMPORTANT], [!WARNING] o [!CAUTION] diventa un riquadro colorato, con la stessa sintassi di GitHub.

• Commenti che non compaiono nella pagina: <!-- una nota visibile solo nel testo -->.
• Sezioni comprimibili con <details> e <summary> dell’HTML, con righe vuote attorno al Markdown all’interno.
• Front matter: un blocco tra due righe --- proprio all’inizio del file, con un titolo, tag o uno stato. DotMD lo mostra come scheda Properties sopra il documento.

Formule e diagrammi

Due extra che sia GitHub sia DotMD disegnano. Una formula sta tra segni di dollaro, $E = mc^2$, o tra doppi segni su una riga a sé: Formule in Markdown con LaTeX. Un diagramma è un blocco di codice contrassegnato mermaid, con il suo testo dentro: Diagrammi Mermaid.

Provalo

Il modo più rapido per imparare i segni è vederli renderizzati. Apri un qualsiasi file .md in DotMD e leggilo formattato, con tabelle, codice, callout, diagrammi e formule disegnati. Leggere è gratis. Nell’editor, il menu Insert scrive i simboli per te, quindi non devi ricordare nulla di tutto questo.

Domande sulla sintassi Markdown

Altre domande