Vai al contenuto principale

Guida alla formattazione

  • Aggiornato

Markdown per Nuovo Reddit

Markdown è il formato in cui sono scritti i contenuti su Reddit. Questa è una guida al particolare Markdown di Reddit, aggiornata per Nuovo Reddit, al 19 settembre 2018.

Informazioni su questo documento

Su Reddit il contenuto basato sul testo (commenti, post di testo e altro) è rappresentato come una variazione specifica per Reddit del formato Markdown, e quel formato è cambiato in Nuovo Reddit, sia per come viene analizzato , che per come viene visualizzato. Questa è una guida a Markdown per Reddit, che spiega in generale come formattare il contenuto su Nuovo Reddit, e nello specifico identifica le aree in cui Markdown per Nuovo Reddit è diverso dal Markdown per Vecchio Reddit.

Chi invia contenuti esclusivamente tramite l' Editor Avanzato predefinito su Nuovo Reddit non ha bisogno dei dettagli spiegati di seguito. Non serve avere queste informazioni per usare Reddit: l'Editor Avanzato è un editor di testo che fornisce tutte le opzioni di formattazione più comuni come il grassetto, il corsivo, le liste, etc.

Al suo interno gli esempi sono presentati come coppie che mostrano prima come il Markdown è scritto nell'editor, poi come viene visualizzato o presentato sullo schermo. Troverai alcune note importanti su Nuovo Reddit  con le principali differenze tra il Markdown per Nuovo Reddit e il Markdown per Vecchio Reddit evidenziate con paragrafi in corsivo contrassegnati con una sfera di cristallo (🔮) e dei suggerimenti generali con l'icona del giglio (⚜️).

Riferimento rapido

Questo è un foglio riassuntivo della sintassi di Markdown. Leggi qua si seguito per una quantità eccessiva di dettagli.

Scritto Visualizzato
_corsivo_ o *corsivo* corsivo
__grassetto__ o **grassetto** grassetto
___grassetto-corsivo___ o ***grassetto-corsivo*** grassetto-corsivo
~~barrato~~ barrato
>!spoiler!< spoiler
^apice o ^(apice) apice
`codice` codice

​

Scritto Visualizzato
https://www.reddit.com https://www.reddit.com
r/announcements r/announcements
u/reddit u/reddit

 

 

​

Scritto:

[link](https://redditinc.com)

oppure

[link][1]

[1]: https://redditinc.com

Visualizzato:

link

​

​

Scritto:

# Intestazione 1
## Intestazione 2

Visualizzato:

Intestazione 1

Intestazione 2

​

Scritto:

- a
- b
  1. c
  2. d

Visualizzato:

  • a
  • b
    1. c
    2. d

​

​

Scritto:

> Lorem blockquote dolor sit amet, consectetur adipiscing elit.
> Sed ullamcorper enim libero, ut luctus lorem ultricies ut.> Aenean sed nulla a mauris posuere aliquam bibendum id ipsum.> Fusce non augue mollis, dictum libero sed, blockquote enim.

Visualizzato:

Lorem blockquote dolor sit amet, consectetur adipiscing elit. Sed ullamcorper enim libero, ut luctus lorem ultricies ut. Aenean sed nulla a mauris posuere aliquam bibendum id ipsum. Fusce non augue mollis, dictum libero sed, blockquote enim.

​

​

Scritto:

| intestazione | intestazione | intestazione | intestazione |
|--------|:-------|-------:|:------:|
| cose  | cose  | cose  | cose  |

Visualizzato:

intestazione intestazione intestazione intestazione
cose cose cose cose

​

​

Scritto (nota l'indentazione):

    fn main() {
        println!("hey")
    }

Visualizzato:

fn main() {
    println!("hey")
}

Dove usare Markdown su Reddit

Il contenuto in Markdown può essere usato in diversi posti su Reddit. Gli usi principali di Markdown sono nel testo dei thread di testo e nei commenti.

Quando invii un post testuale o un commento su Nuovo Reddit, in automatico viene mandato come contenuto non Markdown tramite l'editor avanzato WYSIWYG (almeno su desktop: potrebbero esserci delle differenze su mobile). Se invece fai clic su "Passa a Markdown" nella schermata di creazione del post, puoi invece inviarlo come Markdown. Gli utenti potrebbero preferire Markdown all'editor avanzato per avere un controllo più preciso sul documento, per accedere a funzionalità specifiche che l'editor avanzato non supporta o semplicemente per preferenza personale.

Altri luoghi che supportano Markdown includono:

Esistono differenze significative nel supporto di questi ultimi casi tra Vecchio Reddit e Nuovo Reddit, tra il vecchio parser Markdown e il nuovo parser Markdown. Per dettagli, vedi "Differenze nel supporto dei contenuti tra Vecchio Reddit e Nuovo Reddit"

Markdown per Reddit

Paragrafi e interruzioni di riga

I paragrafi su Reddit sono scritti come linee di testo separate da linee vuote.

Scritto:

Lontano, nei dimenticati spazi non segnati nelle carte geografiche dell’estremo limite della
Spirale Ovest della Galassia, c’è un piccolo e insignificante sole giallo.

A orbitare intorno a esso, alla distanza di centoquarantanove milioni di chilometri, c’è un piccolo,
trascurabilissimo pianeta azzurro–verde, le cui forme di vita, discendenti 
dalle scimmie, sono così incredibilmente primitive che credono ancora che gli orologi da polso
digitali siano un’ottima invenzione.’

Questo pianeta ha, o meglio aveva, un fondamentale problema: la maggior parte dei suoi
abitanti era afflitta da una quasi costante infelicità. Per risolvere il problema
di questa infelicità furono suggerite varie proposte, ma queste perlopiù
concernevano lo scambio continuo di pezzetti di carta verde, un fatto indubbiamente strano, visto che
a essere infelici non erano i pezzetti di carta verde, ma gli abitanti
del pianeta.

Visualizzato:

Lontano, nei bassifondi inesplorati dell'estremità fuori moda del braccio a spirale occidentale della galassia si trova un piccolo sole giallo non considerato.

In orbita attorno a questo a una distanza di circa centoquarantasette milioni di chilometri c'è un piccolo pianeta verde-blu assolutamente insignificante, le cui forme di vita discendenti dalle scimmie sono così incredibilmente primitive da pensare ancora che gli orologi digitali siano un'idea piuttosto carina.

Questo pianeta ha, o meglio aveva, un fondamentale problema: la maggior parte dei suoi abitanti era afflitta da una quasi costante infelicità. Per risolvere il problema di questa infelicità furono suggerite varie proposte, ma queste perlopiù concernevano lo scambio continuo di pezzetti di carta verde, un fatto indubbiamente strano, visto che a essere infelici non erano i pezzetti di carta verde, ma gli abitanti del pianeta.

Nota che le interruzioni di riga non sono visualizzate: le righe adiacenti vengono unite per creare un singolo paragrafo. Le interruzioni di riga possono essere aggiunte esplicitamente terminando le righe con due spazi o con una barra rovesciata (\).

Scritto (nota il doppio spazio alla fine della prima riga):

L'amore è il tutto.  
Noi siamo solo pezzi.

Visualizzato:

L'amore è il tutto.
Noi siamo solo pezzi.

Scritto (nota posizione e direzione della barra):

Al di là delle idee di male\
e di bene c'è un campo.\
Ci vediamo lì.

Visualizzato:

Al di là delle idee di male
e di bene c'è un campo.
Ci vediamo lì.

🔮nbspNota per Nuovo Reddit: creare interruzioni di riga con una barra rovesciata funziona solo su Nuovo Reddit. Mentre la barra rovesciata è più facile da leggere e scrivere dei due spazi, se vuoi la compatibilità con Vecchio Reddit, usa i due spazi per le tue interruzioni di riga.

I paragrafi sono separati da un numero qualsiasi di linee vuote, e queste linee vuote vengono visualizzate; quindi non si può aggiungere una quantità arbitraria di spazio tra i paragrafi semplicemente aggiungendo ulteriori linee vuote.

Scritto:

Liberati dalle preoccupazioni.\
Pensa a chi ha creato il pensiero!



Perché rimani in prigione\
Quando la porta è spalancata?

Visualizzato:

Liberati dalle preoccupazioni.
Pensa a chi ha creato il pensiero!

Perché rimani in prigione
Quando la porta è spalancata?

⚜ Suggerimento: un trucco per inserire righe vuote è quello di creare un paragrafo che non contenga altro che uno "spazio unificatore".

Scritto:

Liberati dalle preoccupazioni.\
Pensa a chi ha creato il pensiero!

&nbsp;

Perché rimani in prigione\
Quando la porta è spalancata?

Visualizzato:

Liberati dalle preoccupazioni.
Pensa a chi ha creato il pensiero!

 

Perché rimani in prigione
Quando la porta è spalancata?

Questo &nbsp; è una specie di entità HTML, utile per una varietà di "trucchi" in Markdown.

Formattazione di base del testo

Il testo in corsivo è rappresentato circondando il testo con un singolo asterisco (*) o con un trattino basso (_).

Scritto:

È solo l'*errore*, e non la _verità_, che si sottrae all'indagine.

Visualizzato:

È solo l'errore, e non la verità, che si sottrae all'indagine.

Il testo in grassetto è rappresentato circondando il testo con doppi asterischi (**) o con doppi trattini bassi (__).

Scritto:

È solo l'**errore**, e non la __verità__, che si sottrae all'indagine.

Visualizzato:

È solo l'errore, e non la verità, che si sottrae all'indagine.

Il testo in grassetto-corsivo è rappresentato circondando il testo con tre asterischi (***) o con tre trattini bassi (___).

Scritto:

È solo l'***errore***, e non la ___verità___, che si sottrae all'indagine.

Visualizzato:

È solo l'errore, e non la verità, che si sottrae all'indagine.

Gli esempi precedenti hanno enfatizzato una singola parola, ma l'enfasi può abbracciare anche più parole.

Tieni presente che negli esempi precedenti le parole sottolineate erano completamente circondate da asterischi o trattini bassi. È anche possibile sottolineare solo parti di parole, ma solo con gli asterischi.

Scritto:

Questo è totalmente sub*der*ma**togli**fico.

Visualizzato:

Questo è totalmente subdermatoglifico.

Il testo barrato è rappresentato circondando il testo con doppie tilde (~~).

Scritto:

La cosa più grande che puoi imparare è
~~amare~~ Reddit e lasciare che Reddit ~~ricambi~~ il tuo amore.

Visualizzato:

La cosa più grande che potrai mai imparare è amare reddit e lasciare che Reddit ricambi il tuo amore.

Gli spoiler possono essere nascosti da una barra di spoiler circondando il testo con >! e !<.

Scritto:

La cosa più grande che puoi imparare è amare >!Reddit e lasciare che Reddit ricambi il tuo amore!<.

Visualizzato:

La cosa più grande che puoi imparare è amare Reddit e lasciare che Reddit ricambi il tuo amore.

L'apice è rappresentato da un testo tra parentesi preceduto da un accento circonflesso (^).

Scritto:

La cosa più grande che puoi imparare è
amare Reddit e lasciare che Reddit ^(ricambi il tuo amore).

Visualizzato:

La cosa più grande che puoi imparare è amare Reddit e lasciare che Reddit ricambi il tuo amore.

Una singola parola può essere messa ad apice facendola precedere da un accento circonflesso, senza bisogno delle parentesi.

Scritto:

La cosa più grande che puoi imparare
è amare ^Reddit e lasciare che ^Reddit ricambi il tuo amore.

Visualizzato:

La cosa più grande che puoi imparare è amare Reddit e lasciare che Reddit ricambi il tuo amore.

🔮 Nota su Nuovo Reddit: esistono delle differenze sostanziali nell'analisi dell'apice tra Vecchio e Nuovo Reddit. Soprattutto Vecchio Reddit, qualche volta non riesce ad analizzare la forma tra parentesi, se questa contiene dei link (come per esempio, ^(a [b](http://example.com))). Nuovo Reddit non supporta (ancora) diversi livelli di apice. Inoltre, entrambi presentano dei bug. Per ottenere una compatibilità ottimale degli apici tra Vecchio e Nuovo Reddit, è necessario rispettare la sintassi dell'apice su una singola parola, senza parentesi e con l'apice su ogni parola, oppure separare in modo alternativo le parole con entità HTML quali "spazio unificatore" (&nbsp;) oppure "spazio di un quarto di larghezza" ( ) (quest'ultimo consente le interruzioni di riga nell'apice).

Scritto:

La cosa più grande che puoi imparare è
amare Reddit e ^lasciare ^che ^Reddit ^ricambi ^il tuo amore.

Visualizzato:

La cosa più grande che puoi imparare è amare Reddit e lasciare che Reddit ricambi il tuo amore.

Scritto:

La cosa più grande che potrai mai imparare è 
amare Reddit ^e lasciare che Reddit ricambi il tuo amore.

Visualizzato:

La cosa più grande che puoi imparare è amare Reddit e lasciare che Reddit ricambi il tuo amore.

Se il testo in apice contiene dei link, l'apice verrà applicato anche al testo del link.

Scritto:

La cosa più grande che puoi imparare
è amare Reddit e ^lasciare ^che ^Reddit ricambi il [^tuo ^amore](https://www.redditgifts.com).

Visualizzato:

La cosa più grande che puoi imparare è amare Reddit e lasciare che Reddit ricambi il tuo amore.

Per gli URL che iniziano con "http://" o "https://" viene automaticamente creato il collegamento ipertestuale. Lo stesso succede con i nomi dei subreddit e i nomi utente. Questi ultimi sono conosciuti rispettivamente come redditlink e userlink. Insieme sono conosciuti come autolink.

Scritto Visualizzato
http://www.reddit.com http://www.reddit.com
https://www.reddit.com https://www.reddit.com
r/announcements r/announcements
r/announcements r/announcements
u/reddit u/reddit
u/reddit u/reddit

⚜Suggerimento: gli URL complessi possono essere interpretati in maniera inaspettata come autolink. Quando trovi un URL che non viene interpretato correttamente, circondalo con delle parentesi angolate (<, >).

Scritto:

<http://example.com/foo/../bar..>

Visualizzato:

http://example.com/foo/../bar..

Un testo arbitrario può essere ipercollegato esplicitamente circondandolo con parentesi quadre, seguito da un URL tra parentesi. È possibile assegnare al link un titolo facoltativo, che è tipicamente mostrato dal browser quando l'utente passa il mouse sopra il link.

Il titolo deve essere circondato da virgolette singole, virgolette doppie o parentesi.

Scritto Visualizzato
[Rumi](https://en.wikipedia.org/wiki/Rumi) Rumi
[Zappa](https://en.wikipedia.org/wiki/Frank_Zappa "Frank Zappa - Wikipedia") Zappa
[Gandhi](https://en.wikipedia.org/wiki/Mahatma_Gandhi 'Mahatma Gandhi - Wikipedia') Gandhi
[Twain](https://en.wikipedia.org/wiki/Mark_Twain (Mark Twain - Wikipedia)) Twain

🔮 Note per Nuovo Reddit: i titoli circondati da parentesi sono supportati solo su Nuovo Reddit. Per la compatibilità usa le virgolette.

I link possono anche essere definiti come riferimenti, al di fuori del paragrafo.

Scritto:

Basta [molto poco] per rendere una vita felice;
è tutto dentro di te, nel tuo [modo di pensare][mdp].

[molto poco]: https://www.reddit.com/r/Meditation/
[mpd]: https://www.reddit.com/r/ChangeMyView/

Visualizzato:

Basta molto poco per rendere una vita felice; è tutto dentro di te, nel tuo modo di pensare.

Come impostazione predefinita, il nome del riferimento è lo stesso del testo tra parentesi, ma il riferimento può essere nominato esplicitamente all'interno di una seconda serie di parentesi, come in [modo di pensare][mdp]. Come i link in linea, i link di riferimento possono avere dei titoli.

⚜️Suggerimento: i collegamenti in stile riferimento sono particolarmente utili per rendere più ordinato un testo con molti link.

Scritto:

Da qualche parte in [la Mancha][lm], in un luogo di cui non mi interessa ricordare il nome,
viveva non molto tempo fa un signore, uno di quelli che ha una [lancia]
e uno [scudo antico][as] su una mensola e tiene un [ronzino magro][sn]
e un levriero per le corse.

[lm]: https://en.wikipedia.org/wiki/La_Mancha
[lancia]: https://en.wikipedia.org/wiki/Holy_Lance "Holy Lance - Wikipedia"
[as]: http://myarmoury.com/feature_shield.html 'The Shield: An Abridged History of its Use and Development'
[sn]: https://en.wikipedia.org/wiki/Epona (Epona - Wikipedia)

Visualizzato:

Da qualche parte in la Mancha, in un luogo di cui non mi interessa ricordare il nome, viveva non molto tempo fa un signore, uno di quelli che ha una lancia e uno scudo antico su una mensola e tiene un ronzino magro e un levriero per le corse.

⚜ Suggerimento: i link possono contenere parentesi solo se sono bilanciate, cioè se ogni "(" è seguita da una ")". Per creare un link usando un URL con delle parentesi non bilanciate, devi escludere le parentesi con una barra rovesciata ("\") o usare la sintassi alternativa per i link in cui racchiudi l'url in delle parentesi angolate, "<" e ">".

Scritto:

[Parentesi](https://en.wikipedia.org/wiki/\()

Visualizzato:

Parentesi

Scritto:

[Parentheses](<https://en.wikipedia.org/wiki/(>)

Visualizzato:

Parentesi

Su Reddit i link devono generalmente includere lo schema URI, per esempio "https://", quindi invece di scrivere [a](www.example.com), scrivi [a](https://www.example.com).

L'insieme completo di prefissi accettati negli URL è "http://", "https://", "ftp://", "mailto:", "git://", "steam://", "irc://", "news://", "mumble://", "ssh://", "ircs://", "ts3server://", "/", "#".

Intestazioni

Le intestazioni delle sezioni hanno sei livelli e sono scritte con cancelletti iniziali (#).

Scritto:

# Dominio

## Regno

### Phylum

#### Classe

##### Ordine

###### Famiglia

Visualizzato:

Dominio

Regno

Phylum

Classe

Ordine
Famiglia

Le intestazioni di livello 1 e 2 possono anche essere scritte sottolineando il testo dell'intestazione con "=" e "-" rispettivamente.

Scritto:

Dominio
======

Regno
-------

Visualizzato:

Dominio

Regno

Elenchi

Gli elenchi possono essere non ordinati (puntati) o ordinati (numerati).

Gli elenchi non ordinati consistono in righe precedute da "-" o "*".

Scritto:

- Agamennone
- Le coefore
- Eumenidi

Visualizzato:

  • Agamennone
  • Le coefore
  • Eumenidi

Scritto:

* Agamennone
* Le coefore
* Eumenidi

Visualizzato:

  • Agamennone
  • Le coefore
  • Eumenidi

Gli elenchi ordinati consistono di linee numerate delimitate da "." o ")".

Scritto:

1) Agamennone
2) Le coefore
3) Eumenidi

Visualizzato:

  1. Agamennone
  2. Le coefore
  3. Eumenidi

Scritto:

1) Agamennone
2) Le coefore
3) Eumenidi

Visualizzato:

  1. Agamennone
  2. Le coefore
  3. Eumenidi

🔮 Nota per Nuovo Reddit: usare ")" per definire una lista ordinata funziona solo su Nuovo Reddit. Per la compatibilità con Vecchio Reddit usa ".".

In Reddit, gli elenchi ordinati devono iniziare con "1".

A parte la numerazione, gli elenchi ordinati e non ordinati sono generalmente analizzati allo stesso modo, quindi i restanti esempi useranno elenchi non ordinati per semplicità.

Ogni singolo elemento in un elenco è definito voce di elenco. Gli elementi possono avere qualsiasi quantità di spazio tra di loro. L'aggiunta di spazio può rendere gli elementi di un elenco complesso più leggibili durante la modifica.

Scritto:

- Agamennone

- Le coefore


- Eumenidi

Visualizzato:

  • Agamennone

  • Le coefore

  • Eumenidi

Gli elementi dell'elenco possono contenere sottoelenchi.

Scritto:

- Omero
 - L'Iliade
 - L'Odissea
 - Eschilo
 - Agamennone
 - Le Coefore
 - Gli Eumenidi

Visualizzato:

  • Omero
    • L'Iliade
    • L'Odissea
  • Eschilo
    • Agamennone
    • Le coefore
    • Eumenidi

Si noti che i sottoelenchi di elementi di elenchi non ordinati devono essere preceduti da almeno due spazi, mentre i sottoelenchi di elementi di elenchi ordinati devono essere preceduti da almeno tre spazi.

Gli elenchi possono contenere i propri paragrafi, le blockquote e altri tipi di contenuto.

Scritto:

- Prima di tutto: Lorem ipsum dolor sit amet, consectetur adipiscing
  elit.

  > Fusce hendrerit, nunc quis rhoncus tristique, neque augue ornare
  > enim, ut aliquam libero diam et ligula. Aliquam sagittis sem sed
  > rutrum luctus. Nunc massa est, egestas eget massa id, lacinia
  > pretium dui. Nam eget consequat eros, eget commodo urna.

- Ma in secondo luogo: Phasellus vitae libero sit amet orci tempor lacinia
  sed at tellus. Curabitur sit amet nibh elit. Quisque pulvinar odio sapien, et condimentum velit convallis et.

  ### Lipsum facts

  |Lorem|Ipsum|Dolor|
  |-----|-----|-----|
  |8    |1    |3    |
  |3    |7    |8    |

  Aenean at dui in sapien sagittis sodales.

Visualizzato:

  • Prima di tutto: Lorem ipsum dolor sit amet, consectetur adipiscing elit.

    Fusce hendrerit, nunc quis rhoncus tristique, neque augue ornare enim, ut aliquam libero diam et ligula. Aliquam sagittis sem sed rutrum luctus. Nunc massa est, egestas eget massa id, lacinia pretium dui. Nam eget consequat eros, eget commodo urna.

  • Ma in secondo luogo: Phasellus vitae libero sit amet orci tempor lacinia sed at tellus. Curabitur sit amet nibh elit. Quisque pulvinar odio sapien, et condimentum velit convallis et.

    Lipsum facts

    Lorem Ipsum Dolor
    8 1 3
    3 7 8

    Aenean at dui in sapien sagittis sodales.

🔮 Nota per Nuovo Reddit: in Markdown, anche su Vecchio Reddit, si può usare il segno + per definire elenchi non ordinati. Per il momento, Nuovo Reddit non riesce ad analizzare tali elenchi.

Blockquote

Le blockquote forniscono un modo per enfatizzare grandi quantità di testo e sono tipicamente usate nei commenti di risposta per citare i commenti di altri. Si creano iniziando una riga con una parentesi angolata a destra (>).

Scritto:

> È così difficile dimenticare il dolore, ma è ancora più difficile
ricordare la dolcezza. Non abbiamo alcuna cicatrice da mostrare per la felicità.
Impariamo così poco dalla pace.

Visualizzato:

È così difficile dimenticare il dolore, ma è ancora più difficile ricordare la dolcezza. Non abbiamo alcuna cicatrice da mostrare per la felicità. Impariamo così poco dalla pace.

Per le virgolette semplici, è sufficiente iniziare la prima riga di un paragrafo con >, come sopra, e l'intera frase sarà citata.

Per le blockquote più complesse, fare precedere ogni riga da >.

Scritto:

> - Prima di tutto: Lorem ipsum dolor sit amet, consectetur adipiscing
>   elit.
>
> - Ma in secondo luogo: Phasellus vitae libero sit amet orci tempor lacinia
>   sed at tellus. Curabitur sit amet nibh elit. Quisque pulvinar odio
>   sapien, et condimentum velit convallis et.
>
> > Fusce hendrerit, nunc quis rhoncus tristique, neque augue ornare
> > enim, ut aliquam libero diam et ligula. Aliquam sagittis sem sed
> > rutrum luctus. Nunc massa est, egestas eget massa id, lacinia
> > pretium dui. Nam eget consequat eros, eget commodo urna.
>
> ### Lipsum facts
>
> |Lorem|Ipsum|Dolor|
> |-----|-----|-----|
> |8    |1    |3    |
> |3    |7    |8    |
>
> Aenean at dui in sapien sagittis sodales.

Visualizzato:

  • Prima di tutto: Lorem ipsum dolor sit amet, consectetur adipiscing elit.

  • Ma in secondo luogo: Phasellus vitae libero sit amet orci tempor lacinia sed at tellus. Curabitur sit amet nibh elit. Quisque pulvinar odio sapien, et condimentum velit convallis et.

Fusce hendrerit, nunc quis rhoncus tristique, neque augue ornare enim, ut aliquam libero diam et ligula. Aliquam sagittis sem sed rutrum luctus. Nunc massa est, egestas eget massa id, lacinia pretium dui. Nam eget consequat eros, eget commodo urna.

Lipsum facts

Lorem Ipsum Dolor
8 1 3
3 7 8

Aenean at dui in sapien sagittis sodales.

Tabelle

Le tabelle sono formate da una riga di intestazione e da un numero variabile di righe per il contenuto. Le colonne sono separate da barre verticali (|) e la riga di intestazione è separata dalle righe per il contenuto da trattini (-).

Scritto:

| Ticker | Investimento | Profitto |
|--------|------------|--------|
| BTC    | $100       | $-50   |
| ETH    | $1000      | $-500  |
| DOGE   | $10000     | $-5000 |

Visualizzato:

Ticker Investimento Profitto
BTC $100 $-50
ETH $1000 $-500
DOGE $10000 $-5000

La seconda riga della tabella, quella piena di trattini, è la riga del marcatore e determina l'allineamento del testo nella colonna. Le colonne nella riga di marcatori che iniziano con : sono allineate a sinistra; le colonne che finiscono con : sono allineate a destra; le colonne che iniziano e finiscono con : sono allineate al centro; le colonne contenenti tutti trattini sono allineate in maniera predefinita (allineate a sinistra).

Scritto:

| Ticker | Investimento | Profitto |
|:-------|-----------:|:------:|
| BTC    | $100       | $-50   |
| ETH    | $1000      | $-500  |
| DOGE   | $10000     | $-5000 |

Visualizzato:

Ticker Investimento Profitto
BTC $100 $-50
ETH $1000 $-500
DOGE $10000 $-5000

Fortunatamente, le colonne non devono essere formattate in modo da allinearsi tra loro per funzionare: possono anche essere disordinate.

Scritto:

| Ticker | Investimento | Profitto |
|:-|-:|:-:|
| BTC | $100 | $-50 |
| ETH | $1000 | $-500 |
| DOGE | $10000 | $-5000 |

Visualizzato:

Ticker Investimento Profitto
BTC $100 $-50
ETH $1000 $-500
DOGE $10000 $-5000

⚜️ Suggerimento: le tabelle possono essere scritte senza la barra verticale (|) di inizio e fine riga, ma il risultato può essere sorprendente quando il parser deve indovinare se la riga è una riga di tabella o qualcos'altro.

Blocchi di codice e codice in linea

Esistono diversi modi di rappresentare il codice in Markdown, che è sempre reso in un font a spaziatura fissa e reso esattamente come scritto: nessun Markdown è interpretato all'interno di una regione di codice.

Brevi frammenti di codice, codice in linea, possono essere incorporati in paragrafi e altro testo e sono delimitati da backtick di apertura e chiusura (`).

Scritto:

Ci sbagliavamo: `goto`\
non è considerato dannoso;\
`goto` vuole aiutare.

Visualizzato:

 

Ci sbagliavamo: goto
non è considerato dannoso;
goto vuole aiutare.

I blocchi di codice più lunghi possono essere rappresentati in diversi modi. Il primo è far rientrare l'intero blocco di codice di quattro spazi.

Scritto:

    hashOut.data = hashes + SSL_MD5_DIGEST_LEN;
    hashOut.length = SSL_SHA1_DIGEST_LEN;
    if ((err = SSLFreeBuffer(&hashCtx)) != 0)
        goto fail;
    if ((err = ReadyHash(&SSLHashSHA1, &hashCtx)) != 0)
        goto fail;
    if ((err = SSLHashSHA1.update(&hashCtx, &clientRandom)) != 0)
        goto fail;
    if ((err = SSLHashSHA1.update(&hashCtx, &serverRandom)) != 0)
        goto fail;
    if ((err = SSLHashSHA1.update(&hashCtx, &signedParams)) != 0)
        goto fail;
        goto fail;
    if ((err = SSLHashSHA1.final(&hashCtx, &hashOut)) != 0)
        goto fail;

Visualizzato:

hashOut.data = hashes + SSL_MD5_DIGEST_LEN;
hashOut.length = SSL_SHA1_DIGEST_LEN;
if ((err = SSLFreeBuffer(&hashCtx)) != 0)
    goto fail;
if ((err = ReadyHash(&SSLHashSHA1, &hashCtx)) != 0)
    goto fail;
if ((err = SSLHashSHA1.update(&hashCtx, &clientRandom)) != 0)
    goto fail;
if ((err = SSLHashSHA1.update(&hashCtx, &serverRandom)) != 0)
    goto fail;
if ((err = SSLHashSHA1.update(&hashCtx, &signedParams)) != 0)
    goto fail;
    goto fail;
if ((err = SSLHashSHA1.final(&hashCtx, &hashOut)) != 0)
    goto fail;

🔮 Nota per Nuovo Reddit: i blocchi di codice indentati sono gli unici che funzionano su Vecchio Reddit. Usali per garantire la compatibilità.

Digitare quattro spazi davanti a ogni riga in un blocco di codice è noioso e soggetto a errori. Il modo più semplice è circondare l'intero blocco di codice con dei recinti di codice. Un recinto di codice è una linea che inizia con tre o più backtick (`) o tre o più caratteri tilde (~).

Scritto:

```
if ((err = SSLHashSHA1.update(&hashCtx, &signedParams)) != 0)
        goto fail;
        goto fail;
```

Visualizzato:

 

if ((err = SSLHashSHA1.update(&hashCtx, &signedParams)) != 0)
        goto fail;
        goto fail;

Scritto:

~~~
if ((err = SSLHashSHA1.update(&hashCtx, &signedParams)) != 0)
        goto fail;
        goto fail;
~~~

Visualizzato:

 

if ((err = SSLHashSHA1.update(&hashCtx, &signedParams)) != 0)
        goto fail;
        goto fail;

Il recinto di apertura e quello di chiusura devono corrispondere, sia il carattere usato, sia le sue ripetizioni.

⚜️ Suggerimento: se lo stesso codice in linea contiene un backtick o un blocco che contiene un recinto di codice, i backtick e i recinti interni possono provocare la chiusura anticipata delle aree di codice. Se succede, i recinti possono essere adattati per accogliere il codice. Il resto di questa sezione riguarda il trattamento dei casi limite.

Considera il seguente esempio.

Scritto:

```

Questo codice non ha funzionato come previsto:

```
if ((err = SSLHashSHA1.update(&hashCtx, &signedParams)) != 0)
        goto fail;
        goto fail;
```

Ma ha fatto del suo meglio.

Visualizzato:

 

Questo codice non ha funzionato come previsto:

if ((err = SSLHashSHA1.update(&hashCtx, &signedParams)) != 0) goto fail; goto fail;

Ma ha fatto del suo meglio.

Questo è un recinto di codice all'interno di un recinto di codice (cioè un blocco di codice Markdown che contiene un esempio Markdown) che non viene visualizzato come desiderato: il codice all'interno del recinto di codice interno non è reso come codice. Invece, il codice appare come testo normale circondato da due blocchi di codice.

Si tratta di un problema facile da risolvere perché la sintassi del recinto del codice ha due delimitatori diversi, (`) e (~), e permette ai blocchi di codice di essere circondati da più di tre delimitatori. Basta usare più backtick nel recinto esterno del codice o usare l'altro delimitatore.

Scritto:

````

Questo codice non ha funzionato come previsto::

```
if ((err = SSLHashSHA1.update(&hashCtx, &signedParams)) != 0)
        goto fail;
        goto fail;
```

Ma ha fatto del suo meglio.

````

Visualizzato:

 

Questo codice non ha funzionato come previsto:

```
if ((err = SSLHashSHA1.update(&hashCtx, &signedParams)) != 0)
        goto fail;
        goto fail;
```

Ma ha fatto del suo meglio.

Scritto:

~~~

Questo codice non ha funzionato come previsto:

```
if ((err = SSLHashSHA1.update(&hashCtx, &signedParams)) != 0)
        goto fail;
        goto fail;
```

Ma ha fatto del suo meglio.

~~~

Visualizzato:

Questo codice non ha funzionato come previsto:

```
if ((err = SSLHashSHA1.update(&hashCtx, &signedParams)) != 0)
        goto fail;
        goto fail;
```

Ma ha fatto del suo meglio.

C'è un trucco simile anche per il codice in linea: quest'ultimo può essere circondato da qualsiasi numero di backtick e l'apertura e la chiusura devono corrispondere. Così, se uno ha bisogno di mettere un singolo backtick all'interno del codice in linea, può semplicemente circondare il codice con due backtick, ad esempio ``questa cosa qui - ` - è un backtick``.

Naturalmente c'è un altro caso complicato: cosa succede se il codice in linea stesso deve iniziare o finire con un backtick - per esempio, se si desidera illustrare come scrivere codice in linea Markdown all'interno del codice in linea? Scrivere solo due backtick per aprire il codice in linea e un singolo backtick per iniziare il codice in linea non funziona perché sembra codice in linea delimitato da tre backtick: ```esempio di codice in linea```. Se si dovesse scrivere solo questo, si perderebbero i backtick interni:

Scritto Visualizzato
```esempio di codice in linea``` esempio di codice in linea

Il Markdown dà un'ultima scappatoia per queste situazioni: qualsiasi spazio intorno al codice in linea è rimosso, il che permette di scrivere i delimitatori del codice in linea, lo spazio e poi il backtick testuale:

Scritto Visualizzato
`` `esempio di codice in linea` `` `esempio di codice in linea`

Questa situazione si presenta più frequentemente per chi scrive Markdown su Markdown (come me!). Spero che non ti capiterà mai.

Infine, cosa succede se si desiderano davvero spazi iniziali o finali nel codice in linea? Beh, allora si è davvero nei guai. Se ci si trova davvero in questa situazione, probabilmente si è abbastanza intelligenti da trovare una soluzione.

Pause tematiche

La pausa tematica, nota anche come "riga orizzontale", è semplicemente una linea orizzontale tracciata attraverso la pagina. Può essere usata per creare una separazione visiva tra i contenuti. Una pausa tematica è scritta come una linea contenente tre o più asterischi (*), trattini (-) o caratteri di sottolineatura (_).

Scritto:

Ecco una storia malinconica sul nonno.

---

Ecco una foto di un asino torpido.

Visualizzato:

Ecco una storia malinconica sul nonno.

Ecco una foto di un asino torpido.

Scritto:

Ecco un vero pappagallo da festa.

***

Qui c'è l'inganno, la decadenza e, alla fine, la morte.

Visualizzato:

Ecco un vero pappagallo da festa.

Qui c'è l'inganno, la decadenza e, alla fine, la morte.

Scritto:

Ecco una porta di fienile arrugginita.

___

Caffè nero.

Visualizzato:

Ecco una porta di fienile arrugginita.

Caffè nero.

Altri suggerimenti e trucchi

Escape alla sintassi di Markdown

L'escape è un modo per dire al parser di non interpretare i caratteri speciali come Markdown, facendoli precedere da una barra rovesciata (\).

A volte, si scopre che il parser ha interpretato il testo in un modo che non era previsto. Questo può accadere, per esempio, se, nel mezzo di un paragrafo, un trattino inizia una nuova riga.

Scritto:

Ho sentito i miei polmoni gonfiarsi con l'impeto del paesaggio
- aria, montagne, alberi, persone. Ho pensato:
"Questo è ciò che significa essere felici".

Visualizzato:

Ho sentito i miei polmoni gonfiarsi per l'impeto del paesaggio

  • aria, montagne, alberi, persone. Ho pensato: "Questo è ciò che significa essere felici".

In questo caso, il trattino è inteso come parte del testo, non come inizio di un elenco. L’escape del trattino con una backslash (barra rovesciata) risolve il problema.

Scritto:

Ho sentito i miei polmoni gonfiarsi con l'impeto del paesaggio
\- aria, montagne, alberi, persone. Ho pensato:
"Questo è ciò che significa essere felici".

Visualizzato:

Ho sentito i miei polmoni gonfiarsi con l'impeto del paesaggio - aria, montagne, alberi, persone. Ho pensato: "Questo è ciò che significa essere felici".

Un altro caso comune in cui la necessità di escape si presenta con le parentesi nei link.

Scritto:

[Parentesi](https://en.wikipedia.org/wiki/))

Visualizzato:

Parentesi)

Questo dovrebbe essere un link all'articolo di Wikipedia sulle parentesi ("https://en.wikipedia.org/wiki/"), ma, in realtà, si tratta di un link a "https://en.wikipedia.org/wiki/". L’escape della parentesi nell'URL fa sì che il parser non la tratti come la parentesi di chiusura della sintassi del link.

[Parentesi](https://en.wikipedia.org/wiki/\))

Visualizzato:

Parentesi

Entità HTML

Markdown supporta le entità HTML, come per esempio la formula piuttosto comune &nbsp; per lo "spazio unificatore". Possono essere una "via di fuga" per scrivere contenuti difficili da rappresentare. Per esempio, &nbsp; è spesso usato per inserire paragrafi "vuoti", fornendo spazi bianchi verticali dove Markdown non permette altrimenti.

In altri casi, le entità HTML sono usate per inserire caratteri che sono difficili da digitare, come quelli al di fuori della gamma ASCII in Unicode, o caratteri che non hanno una rappresentazione visiva.

Alcuni esempi utili:

  • È possibile inserire un trattino con &mdash;. Si tratta di un trattino più lungo del tipico trattino e rappresenta il carattere corretto per separare tra loro le varie frasi.
  • È possibile inserire vari caratteri di spazi vuoti non ASCII per inserire spazi vuoti dove Markdown altrimenti non li permetterebbe. Se desideri semplicemente inserire una quantità arbitraria di spazio tra due parole, ciò è possibile, per esempio, inserendo più caratteri “spazio lungo" ( ).

Suggerimenti per i robot

Durante la transizione, abbiamo visto sorgere alcune incompatibilità nella sintassi utilizzata dai bot. Qui sono riportate alcune note da quelle esperienze, così come alcune informazioni generali sulla pubblicazione automatica di Markdown

(Suggerimento veloce: questa sezione avrebbe bisogno dell'aiuto degli autori di bot!)

  • Nei link, non mettere spazi tra il testo ([...]) e l'URL ((http://example.com)). Questo funzionava in Vecchio Reddit ma non in Nuovo Reddit.

  • Si possono usare gli escape con barra rovesciata per tutte le parentesi negli URL dei link (non gli autolink), come [testo](http://example.com/foo\(bar). Le parentesi devono essere bilanciate o non saranno analizzate come link, quindi è sufficiente un escape a tutte le parentesi per far sì che tutti i link con parentesi siano analizzati correttamente.

  • In alternativa, usare la sintassi della parentesi angolate per gli URL dei link ([testo](<http://example.com>), che accetta parentesi sbilanciate. In questo caso, però, è necessario eseguire l'escape delle parentesi angolate nell'URL, come <code>%3C</code> e <code>%3E</code>.

  • Se si pubblicano autolink (URL grezzi senza la sintassi delle parentesi), è opportuno inserirli tra parentesi angolate (< >) ed eseguire l'escape delle parentesi angolate all'interno dell'URL come %3C</code> e <code>%3E. Questo eviterà qualsiasi ambiguità nell’analisi, in particolare alla fine degli autolink. Nota che anche all'interno delle parentesi gli autolink non possono contenere spazi, esegui quindi l'escape degli spazi scrivendoli come%20.

  • Non c'è proprio modo di evitare l'escape di qualcosa quando si pubblicano link arbitrari come bot, se si desidera che tutti gli URL siano analizzati come previsto. I dettagli sull'analisi dei link si trovano nelle specifiche.

  • Il nuovo parser e il vecchio parser trattano gli escape HTML (come &nbsp;) in modo diverso: il vecchio li conserva, sia nel testo sia nei link; il nuovo li decodifica durante l'analisi in modo che i client (molti dei quali non sono browser web) non siano esposti a essi. Questo è vero sia nel testo sia nei link ed è specificato come tale da CommonMark. Non sappiamo dire che impatto può avere sui bot, né abbiamo suggerimenti in questo momento.

  • Se c'è la possibilità che l’apice contenga dei link, scrivili rendendo apice ogni parola o separando le parole in apice con uno "spazio di un quarto di larghezza". La sintassi più accattivante ^(...) non è affidabile su Vecchio Reddit quando è abbinata a dei link.

Suggerimenti di compatibilità con Markdown per Reddit

Questi sono alcuni suggerimenti per scrivere un Markdown compatibile con l’analisi Markdown di Vecchio Reddit (finché il vecchio parser rimane in uso).

Alcuni dei suggerimenti sono "facili" perché hanno equivalenti che sono altrettanto buoni in Vecchio Reddit; alcuni sono "sfortunati" perché, beh, favoriscono una sintassi meno bella.

È probabile che, in futuro, il vecchio parser sarà eliminato completamente (oggi è usato solo sul vecchio client web - i client mobili usano il nuovo). A quel punto, questi suggerimenti potrebbero cambiare.

D'altra parte, se non ti interessa la formattazione su Vecchio Reddit, continua e fai pure il contrario di tutti questi suggerimenti!

Suggerimenti di compatibilità facili

  • Usare le virgolette per i titoli dei link come [testo](http://example.com "titolo") (al posto delle parentesi per i titoli dei link). Vecchio Reddit non supporta le parentesi in questo caso.

  • Inizia e termina le colonne della tabella con le barre verticali (|). Sono tecnicamente facoltative, ma a volte si verificano delle sorprese se non vengono utilizzate. Sia Vecchio Reddit sia Nuovo Reddit hanno stranezze diverse.

  • Delimita gli elenchi ordinati con punti anziché con parentesi, per esempio (1. Primo). Vecchio Reddit non supporta la seconda opzione.

  • Delimita gli elenchi non ordinati con - o *, e non con +. Attualmente, Nuovo Reddit non supporta l'ultima opzione.

Suggerimenti di compatibilità sfortunati

  • Usa i doppi spazi invece di una barra rovesciata per indicare i ritorni a capo. Vecchio Reddit supporta solo i doppi spazi.

  • Usa blocchi di codice rientranti invece dei recinti di codice. Vecchio Reddit supporta solo blocchi di codice rientranti.

  • Non usare enfasi annidate come  _questo è __davvero__ importante_. Sì, indovinato: non funziona su Vecchio Reddit.

  • Non usare livelli multipli di apice (noti anche come "torri"). Non funziona in Nuovo Reddit (almeno non ancora).

  • Continua a usare trucchi comuni per fare in modo che l'apice supporti gli spazi, come mettere in apice ogni parola o unirle con caratteri di spazio Unicode esotici ( &nbsp; o zero-width. Evita la sintassi dell'apice tra parentesi,  ^(...) poiché viene spesso interpretata in modo errato su Vecchio Reddit.

Maggiori informazioni su Markdown su Reddit

Il parser markdown di Nuovo Reddit, snoomark, è una variazione di Markdown per GitHub (GFM), basato su CommonMark, con le estensioni per tabelle GFM e autolink, così come un’estensione per il testo barrato modificata. Include anche estensioni specifiche di Reddit e stranezze di compatibilità specifiche di Reddit che si discostano da CommonMark.

Snoomark è un progetto a valle di comrak, che è a sua volta una reimplementazione di cmark-gfm, l'implementazione di CommonMark di GitHub con estensioni GitHub (GFM), che è a sua volta a valle di cmark, l'implementazione di riferimento di CommonMark. Lo stesso snoomark non è (ancora) open source, ma le modifiche a comrak vengono regolarmente unite a snoomark.

Man mano che più redditor hanno iniziato a usare gli strumenti di creazione e formattazione dei post su Nuovo Reddit, la filosofia intorno al supporto Markdown ha subito delle fluttuazioni. Originariamente, il piano era di passare a qualcosa che si avvicinasse a CommonMark e abbandonare ogni compatibilità con le "stranezze" di Vecchio Reddit; ma con il procedere del rollout quella posizione si è ammorbidita e una serie di stranezze di compatibilità sono state aggiunte al nuovo parser.

In questo momento, non ci aspettiamo che molte altre stranezze di compatibilità siano aggiunte a Nuovo Reddit: è più probabile che Vecchio Reddit sia aggiornato al nuovo parser. In questo scenario, ci sarà una certa quantità (si spera piccola) di vecchio contenuto non più visualizzato correttamente a causa delle differenze di analisi.

Tuttavia, le evoluzioni future continueranno a essere valutate man mano che il rollout continua e i bug vengono segnalati.

Il rendering di Markdown in Nuovo Reddit è notevolmente diverso da Vecchio Reddit e dalla maggior parte dei siti web che consumano Markdown, in quanto non è reso direttamente in HTML da Markdown, ma attraverso un formato intermedio, di proprietà di Reddit, chiamato RTJSON ("Rich Text JSON"). Questo formato è progettato per essere facilmente consumato e reso da tutti i client Reddit, web e mobile, mentre in Vecchio Reddit, i client mobili avevano diverse difficoltà a rendere il contenuto Markdown in modo coerente. I dettagli del formato RTJSON non sono attualmente pubblicati.

Motivazione del passaggio a CommonMark

Il nuovo parser è stato creato perché il vecchio parser era difficile da manutenere, codice C critico per la sicurezza, e aggiungervi nuove funzionalità era proibitivo. Il nuovo parser non è scritto in C e quindi è più mantenibile. Inoltre, la riprogettazione ha richiesto nuove caratteristiche e la capacità futura di aggiungere nuove funzionalità.

La velocità di sviluppo con il vecchio parser era praticamente pari a 0. Il nuovo parser riceve le modifiche in base alle necessità e la maggior parte di esse non richiede una verifica di sicurezza.

La riprogettazione è stata anche un'opportunità per aggiornare il vecchio dialetto markdown di Reddit a un dialetto CommonMark moderno basato sugli standard, dove può ricevere i benefici del continuo sviluppo a monte e del lavoro sugli standard, oltre a mettersi al passo con circa 6 anni di evoluzione di Markdown (mentre il parser di Vecchio Reddit era stagnante). Questa decisione ha naturalmente portato a molte lamentele per il fatto che certe sintassi di Vecchio Reddit non funzionano in Nuovo Reddit, ma abbiamo gradualmente aggiunto la retrocompatibilità per le stranezze più comuni.

Il Markdown di Nuovo Reddit riceve inoltre diverse nuove delicatezze ereditate da CommonMark, in particolare interruzioni di riga con un backslash finale e blocchi di codice delimitati da recinti invece che da rientri. Ovviamente, durante il periodo di transizione, questi non sono compatibili con Vecchio Reddit, ma alla fine ci aspettiamo che siano "sicuri" da usare senza preoccuparsi troppo della compatibilità - i client mobili già comprendono l'output del nuovo parser; è solo il vecchio client web che non lo fa (ancora).

Probabilmente, l'unica alternativa seria all'aggiornamento a CommonMark sarebbe stata quella di fare una riscrittura completa del vecchio parser in un linguaggio sicuro, conservando tutte le peculiarità di Reddit. Questo non era visto come desiderabile, sia a causa della mole di lavoro richiesta, sia perché avrebbe fatto comodo a tutti tranne che a Reddit. Il nuovo parser, d'altra parte, è basato su un parser CommonMark attivamente sottoposto a manutenzione, che è utile per chiunque voglia analizzare CommonMark. A lungo termine, un comportamento più simile a CommonMark fornirà un'esperienza più fluida per coloro che usano CommonMark altrove, soprattutto quelli che sono tecnicamente esperti, dato che la grande maggioranza degli utenti di Nuovo Reddit sta usando l'Editor avanzato. Ora Reddit è in grado di partecipare alla comunità CommonMark a monte (e ha già influenzato le implementazioni a monte e la specifica CommonMark). Anche in questo caso, la combinazione di una base di codice di cui curare la manutenzione e la presenza di uno standard a cui conformarsi fanno sì che Reddit possa mantenere il proprio parser aggiornato agli standard che si evolvono.

Differenze tra il Markdown di Vecchio Reddit, il Markdown di Nuovo Reddit e CommonMark

Il Markdown per Nuovo Reddit eredita sia dal Markdown per Vecchio Reddit sia da CommonMark / GFM, ma differisce anche da entrambi. Questa sezione elenca le differenze note in Markdown per Nuovo Reddit dal Markdown per Vecchio Reddit e da CommonMark / GFM. Non è completa.

Le differenze rispetto a Vecchio Reddit sono spesso ereditate da CommonMark. Nota che per chi desidera che il suo contenuto sia reso accuratamente per gli utenti di Vecchio Reddit, si può scegliere di non utilizzare queste funzionalità (vedi anche "Suggerimenti di compatibilità con Markdown per Reddit"). Le differenze rispetto a CommonMark spesso esitono per supportare le "stranezze" di Markdown per Vecchio Reddit. Le differenze rispetto all'uno o all'altro possono essere considerate bug o meno, a seconda di chi e di quando sta facendo le considerazioni.

Estensioni specifiche per Reddit

  • Testo spoiler: testo spoiler (>!spoiler!<) è specifico di Reddit.

  • Apice: non esiste uno standard di apice e Reddit ha una sintassi propria che continua ad essere supportata (^, ^(...)).

  • Barrato: la sintassi di Reddit è diversa dall'estensione GFM.

  • Redditlink e userlink: i nomi dei subreddit e degli utenti Reddit, preceduti da  /r/, r/, /u/ e  u/, sono automaticamente collegati.

  • Rich text media: Reddit supporta invii contenenti immagini, video e GIF e questi sono codificati nel Markdown con una sintassi di immagine in linea personalizzata. Questa caratteristica è supportata solo dall'Editor avanzato: attualmente, sarebbe estremamente complicato scrivere manualmente la sintassi.

  • I paragrafi che contengono solo un singolo spazio a larghezza zero (zero-width) sono paragrafi vuoti perché questo carattere non viene visualizzato. È supportato dall'Editor avanzato.

Nuove caratteristiche ereditate da CommonMark

  • Gli elenchi ordinati possono essere scritti con le parentesi, mentre Vecchio Reddit supportava solo gli elenchi ordinati con i punti: 1) e non solo 1.

  • I ritorni a capo possono essere scritti terminando le righe con \, mentre Vecchio Reddit supportava questa opzione solo terminando le righe con un doppio spazio. Questa sintassi è più leggibile e meno sorprendente della sintassi a doppio spazio.

  • I blocchi di codice possono essere scritti con recinti circostanti, al posto del rientro (``` o ~~~). Questa sintassi popolare è probabilmente più scrivibile e leggibile della sintassi di rientro.

Differenze rispetto a Markdown per Vecchio Reddit

  • La sintassi dell'apice tra parentesi (^(super duper)) è analizzata in modo più affidabile (per esempio, l'apice contenente link funziona correttamente) e, una volta eliminato il vecchio parser, dovrebbe essere in genere preferibile rispetto alla sintassi non tra parentesi (^super).

  • L'apice è analizzato in modo leggermente diverso nei casi estremi: per esempio, ^(^b).

  • Livelli multipli annidati di apice sono resi come un singolo livello di apice. Dovrebbe essere risolto in futuro.

    • Ticket: CREATE-1599

  • Nuovo Reddit non analizza correttamente gli apici non tra parentesi quando precedono una parola che è seguita da una parentesi quadra di chiusura, una parentesi di chiusura o un asterisco di chiusura.

    • Ticket: CREATE-2474

  • Le parentesi senza escape nei link devono essere bilanciate.

    • Discussioni precedenti: 1
    • Ticket: CREATE-1662

  • I sottoelenchi richiedono almeno due spazi di rientro per gli elenchi non ordinati e tre per gli elenchi ordinati, dove Vecchio Reddit richiedeva solo uno spazio.

    • Discussioni precedenti: 1
    • Ticket: CREATE-1702

  • La prima cella di intestazione della tabella non può essere vuota se non è preceduta da una barra verticale (|); per esempio, quanto segue non funziona:

    (questa riga è un trucco per aprire un blocco di codice di Vecchio Reddit, non fa parte dell'esempio)

 |B|C
-|-|-
d|e|f
    • Discussioni precedenti: 1
    • Ticket: CREATE-1701

  • La prima cella "marcatore" della tabella non può essere un trattino seguito da uno spazio se non è preceduta da una barra verticale (|), ma sarà invece interpretata come l'inizio di un elenco. Per esempio, quanto segue non funziona:

    (questa riga è un trucco per aprire un blocco di codice di Vecchio Reddit, non fa parte dell'esempio)

A | B
- | -
c | d
    • Discussioni precedenti: 1
    • Ticket: CREATE-1708

  • Il testo spoiler non ha bisogno di essere "affiancato"; cioè, i delimitatori del testo spoiler (>! e !<) saranno analizzati come tali, indipendentemente dalla loro adiacenza a spazi vuoti e punteggiatura.

    • Discussioni precedenti: 1
    • Ticket: CREATE-1534

  • Il testo spoiler con blockquote, cioè con i blockquote scritti con >! invece di >, non è supportato.

    • Ticket: CREATE-1723

  • La sintassi dei link non permette spazi tra le parentesi quadre ([]) e le parentesi tonde (()).

    • Discussioni precedenti: 1 2
    • Ticket: CREATE-1438

  • Più di due caratteri tilde (~) nella sintassi barrata (per esempio, a ~~~b~~~ c) sono trattati diversamente: in Vecchio Reddit gli extra non sono consumati, mentre in Nuovo Reddit sì. Inoltre, in Nuovo Reddit, più di due caratteri tilde all'inizio di una riga possono essere interpretati come recinti di codice.

  • Le righe che non contengono altro che cancelletti (#) sono gestite in modo diverso: in Vecchio Reddit, tali righe sono interamente consumate e non visualizzate; in Nuovo Reddit, 6 o meno cancelletti sono resi come un'intestazione vuota, mentre più di 6 sono resi come un paragrafo contenente cancelletti.

  • Alcuni casi estremi nell’analisi dei link contenenti spazi, in particolare per quanto riguarda la loro interazione con i titoli dei link, sono diversi.

  • Esistono altri casi di differenze di analisi dei link, alcuni considerati bug e altri incerti.

    • Discussioni precedenti: 1
    • Ticket: CREATE-2206

  • Alcuni casi di analisi "interno della parola" in grassetto+corsivo (noti anche come strong+emph) sono diversi. Ad esempio, Vecchio Reddit analizzerà a**_b_**c come grassetto+corsivo mentre CommonMark non lo fa.

    • Discussioni precedenti: 1

  • Gli elenchi ordinati devono iniziare da "1". Altri numeri iniziali non sono supportati. Vecchio Reddit analizzava altri numeri iniziali, anche se rendeva sempre gli elenchi partendo da 1.

  • Nuovo Reddit permette coerentemente l'enfasi annidata, come _a __b c b__ d_, mentre, in molti casi, Vecchio Reddit lo analizza male.

  • I link all'interno di altri link sono analizzati in modo diverso: per esempio, [[a](http://example.com)](http://example.com)

  • Il testo del link di Nuovo Reddit non permette lo spoiler all'interno del testo del link.

    • Ticket: CREATE-2623

  • Gli elenchi non ordinati delimitati con + non funzionano in Nuovo Reddit. Si tratta di una violazione delle specifiche di CommonMark.

    • Ticket: CREATE-2403

  • Le intestazioni non possono contenere formattazione in linea come il corsivo in Nuovo Reddit. Si tratta di una violazione delle specifiche di CommonMark.

    • Ticket: CREATE-2668

  • Similmente, Nuovo Reddit ammette il prefisso dell'URL da solo in quanto URL valido, mentre Vecchio Reddit richiede che il prefisso sia seguito da altri caratteri.

  • Il contenuto del paragrafo seguito da una riga che sembra un elenco non ordinato è interpretato come la chiusura di un paragrafo e l'apertura di un elenco non ordinato, mentre Vecchio Reddit continuava il paragrafo.

  • Le definizioni dei link di riferimento possono apparire all'interno dei blockquote.

  • Gli spazi di codice in linea che contengono backtick possono essere contenuti con qualsiasi numero di backtick sequenziali, mentre in Vecchio Reddit i backtick più esterni devono essere la più lunga stringa di backtick nel blocco di codice. `` `code` `` funziona in entrambi, ` ``code`` ` funziona solo in Nuovo Reddit.

  • Gli elementi di blocco annidati (come gli elenchi, i blockquote e le tabelle) possono essere aperti sulla stessa riga degli elementi dell'elenco.

Differenze rispetto a CommonMark / GFM

  • Le immagini incorporate non sono supportate in modalità Markdown, ma solo mediante l'Editor avanzato.

  • La sintassi per gli apici è come in Vecchio Reddit, non comrak.

  • Gli elenchi ordinati devono iniziare da "1". Altri numeri iniziali non sono supportati.

  • I link possono contenere spazi.

  • Le righe che contengono solo cancelletti (#) sono trattate diversamente.

  • Le intestazioni non richiedono spazi dopo i cancelletti.

  • Le intestazioni con più di 6 cancelletti sono analizzate diversamente, come intestazioni di livello 6 con cancelletti nel testo dell'intestazione (per esempio, #######valhallaforolaf). In CommonMark, tali costrutti non sono analizzati come intestazioni.

  • Una riga di celle di tabella può iniziare con un trattino seguito da uno spazio, mentre in CommonMark ciò aprirebbe un nuovo elenco non ordinato:

    (questa riga è un trucco per aprire un blocco di codice di Vecchio Reddit, non fa parte dell'esempio)

A | B | C
--|---|--
- | e | f

    (nota però che questo non si applica attualmente alla riga "marcatore" che segue la riga di intestazione, quindi quanto segue non è analizzato come una tabella,

    (questa riga è un trucco per aprire un blocco di codice di Vecchio Reddit, non fa parte dell'esempio)


A | B | C
- | - | -
- | e | f

    mentre ne fa parte in Vecchio Reddit).

  • Il barrato richiede due caratteri tilde (~~) per Vecchio Reddit, non uno, per CommonMark.

  • I link relativi non sono supportati.

  • L'HTML in linea non è supportato.

  • Gli elenchi non ordinati delimitati con + non funzionano in Nuovo Reddit.

  • Le intestazioni non possono contenere formattazione in linea arbitraria, come il corsivo, in Nuovo Reddit.

Differenze nel supporto dei contenuti tra Vecchio Reddit e Nuovo Reddit

Nella sezione "Dove usare Markdown su Reddit" vengono descritte le caratteristiche specifiche di Reddit che accettano Markdown come input. Per ora, esistono differenze significative nel supporto di questi vari casi tra Vecchio Reddit e Nuovo Reddit, il vecchio parser Markdown e il nuovo parser Markdown.

Ecco gli sporchi dettagli.

  • selftext: mentre Nuovo Reddit usa il nuovo parser/renderer Markdown per visualizzare il selftext nella maggior parte delle posizioni, anche nella pagina del post e nella "lightbox" (il popup che appare facendo clic su un post nella pagina dell’elenco), usa il vecchio parser Markdown nelle anteprime degli elenchi, sia nella visualizzazione a schede predefinita sia nell'"expando" (cioè i dettagli che si aprono dopo aver fatto clic sull'icona con due frecce opposte) nella visualizzazione Classic.

  • wiki: attualmente reso solo tramite Vecchio Reddit.

  • descrizione subreddit_ non interpretato come Markdown in Nuovo Reddit. Inoltre, il contenuto precedentemente multiriga è limitato a una sola riga.

  • testo di presentazione del subreddit: non viene visualizzato in Nuovo Reddit.

  • barra laterale "area di testo" di Nuovo Reddit: usa il renderer di Vecchio Reddit.

  • regole del subreddit: sempre rese con il renderer di Vecchio Reddit.

  • Testo "info" dei profili utente in nuovo stile: reso sempre con il renderer di Vecchio Reddit.

Differenze tra Editor avanzato e Markdown

L'editor avanzato WYSIWYG supporta generalmente la maggior parte delle caratteristiche di Markdown che Reddit supporta, ma presenta alcune limitazioni. Nei dettagli, l'Editor avanzato memorizza i suoi documenti come Markdown, ma la sua interfaccia non supporta tutte le funzionalità del Markdown di Reddit.

  • Le entità HTML non possono essere inserite nell'Editor avanzato.

  • L'Editor avanzato ha dei "limiti di annidamento" molto più bassi del Markdown grezzo. I limiti di annidamento hanno un impatto sulla profondità che gli elenchi annidati e i blockquote possono creare nel documento.

  • I file multimediali come immagini e video possono essere incorporati nel contenuto tramite l'Editor avanzato ma non nel markdown grezzo.

  • L'Editor avanzato supporta solo un singolo livello di intestazione.

  • L'Editor avanzato non supporta l'inserimento di elementi di blocco arbitrari come gli elenchi, le virgolette e le tabelle all'interno di elenchi o virgolette.

  • L'Editor avanzato non supporta le definizioni di riferimento dei link: i link ripetuti devono essere inseriti ogni volta.

  • L'Editor avanzato non supporta i ritorni a capo.

  • L'Editor avanzato è in grado di creare righe vuote, mentre Markdown no. Lo fa con un trucco retrocompatibile, inserendo paragrafi contenenti un singolo spazio a larghezza zero (zero-width), che il parser Markdown converte successivamente in un paragrafo vuoto. Tecnicamente, chi usa Markdown può usare lo stesso trucco.

Anche se la pagina di invio offre l'opzione di passare dalla modalità Editor avanzato a Markdown, è bene essere prudenti nell'eseguire questa operazione. Benché ci si aspetti che il passaggio dall'Editor avanzato a Markdown non comporti perdite, non è vero il contrario. Per esempio, se Markdown contiene entità HTML, queste saranno convertite in Unicode durante la conversione, gli elenchi profondamente annidati andranno persi, ecc. Inoltre, tornando a Markdown dall'Editor avanzato, il Markdown inserito andrà perso e sarà sostituito dal Markdown generato dall'Editor avanzato.

Crediti e ulteriori letture

Un grande ringraziamento a u/brson per aver creato questo documento e aver lavorato così diligentemente per migliorare il nostro parser. L'organizzazione di base di questa pagina e il suo contenuto sono stati influenzati da u/AnteChrono con il suo Reddit Markdown Primer, u/Raerth con il suo Reddit Comment Formatting, dalla pagina wiki esistente sul "commentare" e dalla pagina della Guida di CommonMark.

Citazioni e riferimenti usati come esempi:

Articoli correlati