Guida alla sintassi Markdown
Una guida rapida e chiara al Markdown di tutti i giorni. Ogni blocco mostra la sintassi e il risultato che ottieni.
Cos'è il Markdown?
Il Markdown è un modo leggero per aggiungere formattazione al testo semplice. Invece di pulsanti e menu, usi pochi simboli semplici, come # per un titolo o * per l'enfasi, che restano leggibili anche come testo originale.
Creato da John Gruber e Aaron Swartz nel 2004, è diventato lo standard per README, documentazione, appunti e siti come GitHub e Reddit. Dato che è solo testo, quello che scrivi resta portabile e leggibile ovunque.
Questa guida copre la sintassi che userai di più. Apri qualsiasi esempio in Markdown Peek e premi la barra spaziatrice per passare dal sorgente al risultato formattato.
Titoli
Inizia una riga con da uno a sei caratteri #. Più cancelletti significano un titolo più piccolo e di livello più basso.
Markdown
# Heading 1 ## Heading 2 ### Heading 3 #### Heading 4
Risultato
Heading 1
Heading 2
Heading 3
Heading 4
Grassetto, corsivo e altro
Racchiudi il testo tra simboli per dargli enfasi. Puoi combinarli liberamente.
Markdown
**Bold text** *Italic text* ***Bold and italic*** ~~Strikethrough~~ `Inline code`
Risultato
Bold text
Italic text
Bold and italic
Strikethrough
Inline code
Elenchi
Usa un trattino, un asterisco o un più per gli elenchi puntati, e i numeri per quelli ordinati. Rientra per annidare.
Markdown
- First item - Second item - Nested item - Third item 1. Step one 2. Step two
Risultato
- First item
- Second item
- Nested item
- Third item
- Step one
- Step two
Link
Metti il testo visibile tra parentesi quadre e l'indirizzo tra parentesi tonde. Un indirizzo web o di posta semplice diventa un link da solo.
Markdown
[Markdown Peek](https://markdownpeek.com) https://markdownpeek.com
Immagini
Un'immagine è un link preceduto da un punto esclamativo. Il testo tra parentesi quadre è il testo alternativo.
Markdown
Risultato
Citazioni
Inizia una riga con > per citarla. Aggiungi un altro > per annidare una citazione dentro un'altra.
Markdown
> A quote worth remembering. > > > And a nested one.
Risultato
A quote worth remembering.
And a nested one.
Codice
Racchiudi il codice in linea tra apici inversi singoli e i blocchi interi tra tripli apici inversi. Aggiungi il nome di un linguaggio e Markdown Peek colora il codice, come GitHub.
Markdown
Use `backticks` for inline code.
```js
function hi() {
console.log("Hello");
}
```Risultato
Use backticks for inline code.
function hi() {
console.log("Hello");
}Tabelle
Separa le colonne con barre verticali e sottolinea la riga di intestazione con trattini. I due punti impostano l'allineamento.
Markdown
| Feature | Supported | |---------|:---------:| | Tables | Yes | | Code | Yes |
Risultato
| Feature | Supported |
|---|---|
| Tables | Yes |
| Code | Yes |
Linee orizzontali
Tre o più trattini, asterischi o trattini bassi su una riga da soli disegnano un divisore.
Markdown
Above the line. --- Below the line.
Risultato
Above the line.
Below the line.
Elenchi di attività
Un elemento dell'elenco con [ ] è un'attività aperta, e con [x] è un'attività completata.
Markdown
- [x] Read the guide - [ ] Set as default app
Risultato
Riquadri
Inizia una citazione con [!NOTE], [!TIP], [!IMPORTANT], [!WARNING] o [!CAUTION] per trasformarla in un riquadro colorato, come su GitHub.
Markdown
> [!NOTE] > Useful to know, even when skimming. > [!WARNING] > Needs attention right away.
Risultato
Note
Useful to know, even when skimming.
Warning
Needs attention right away.
Note a piè di pagina
Aggiungi [^1] dove serve una nota e scrivi la nota in un punto qualsiasi più in basso. Markdown Peek numera le note, le elenca in fondo e ti riporta al punto in cui eri.
Front matter
Le coppie chiave e valore tra due righe --- in cima a un file, come nei post di un blog e nelle skill degli agenti, appaiono come una tabella chiara.
Markdown
--- title: Lofoten author: Sam tags: travel --- # Five nights in March
Risultato
| title | author | tags |
|---|---|---|
| Lofoten | Sam | travel |
Five nights in March
Caratteri di escape
Metti una barra rovesciata prima di un simbolo per mostrarlo così com'è invece che come formattazione.
Markdown
\*Not italic\* \# Not a heading
Risultato
*Not italic*
# Not a heading
Formule con LaTeX
Racchiudi il LaTeX tra singoli simboli del dollaro per le formule dentro una frase, o tra doppi simboli del dollaro per una formula su una riga propria. Markdown Peek le mostra entrambe, offline.
Markdown
Inline math like $E = mc^2$ works in a sentence. $$ a^2 + b^2 = c^2 $$
Risultato
Inline math like E = mc2 works in a sentence.
a2 + b2 = c2
Diagrammi con Mermaid
Apri un blocco di codice con mermaid e descrivi un diagramma di flusso o di sequenza in testo semplice. Markdown Peek lo disegna per te, in modalità chiara o scura.
Markdown
```mermaid flowchart LR A[Write] --> B[Preview] B --> C[Share] ```
Risultato
Leggi il Markdown al meglio sul tuo Mac
Markdown Peek mostra qualsiasi file .md in un pulito stile GitHub, con codice a colori, Quick Look nel Finder e salvataggio in PDF. Gratis sul Mac App Store.
