https://stackoverflow.com/questions/4823468/comments-in-markdown

https://daringfireball-net.translate.goog/projects/markdown/syntax?_x_tr_sl=en&_x_tr_tl=it&_x_tr_hl=it&_x_tr_pto=wapp#link

https://daringfireball.net/projects/markdown/syntax#link

https://daringfireball.net/projects/markdown/syntax

HTML IN LINEA

La sintassi di Markdown ha uno scopo: essere usata come formato per scrivere per il web.

Markdown non è un sostituto dell'HTML, né si avvicina ad esso.
La sua sintassi è molto piccola, corrispondente solo a un sottoinsieme molto piccolo di tag HTML.
L'idea non è quella di creare una sintassi che semplifichi l'inserimento di tag HTML. A mio avviso, i tag HTML sono già facili da inserire.
L'idea di Markdown è di semplificare la lettura, la scrittura e la modifica della prosa.
HTML è un formato di pubblicazione ; Markdown è un formato di scrittura.
Pertanto, la sintassi di formattazione di Markdown risolve solo i problemi che possono essere trasmessi in testo normale.

Per qualsiasi markup che non è coperto dalla sintassi di Markdown, usi semplicemente lo stesso HTML.
Non è necessario prefarlo o delimitarlo per indicare che stai passando da Markdown a HTML; usi solo i tag.

Le uniche restrizioni sono che gli elementi HTML a livello di blocco, ad esempio <div>, <table>, <pre>, <p>, ecc.,
devono essere separati dal contenuto circostante da righe vuote e i tag di inizio e fine del blocco non devono essere rientrati con tabulazioni o spazi.
Markdown è abbastanza intelligente da non aggiungere tag extra (non desiderati)

attorno ai tag HTML a livello di blocco.

Ad esempio, per aggiungere una tabella HTML a un articolo Markdown:

This is a regular paragraph.

<table>
        <tr>
                <td>Foo</td>
        </tr>
</table>

This is another regular paragraph.

Si noti che la sintassi di formattazione Markdown non viene elaborata all'interno di tag HTML a livello di blocco. Ad esempio, non puoi usare lo stile Markdown emphasisall'interno di un blocco HTML.

I tag HTML a livello di estensione, ad esempio <span>, <cite> o <del>, possono essere utilizzati ovunque in un paragrafo, un elemento di elenco o un'intestazione di Markdown. Se lo desideri, puoi persino utilizzare i tag HTML invece della formattazione Markdown; ad esempio, se preferisci utilizzare HTML<a>o <img>tag invece del collegamento di Markdown o della sintassi dell'immagine, vai avanti.

A differenza dei tag HTML a livello di blocco, la sintassi di Markdown viene elaborata all'interno di tag a livello di estensione.

FUGA AUTOMATICA PER CARATTERI SPECIALI

In HTML, ci sono due caratteri che richiedono un trattamento speciale: < e &. Le parentesi angolari sinistre vengono utilizzate per iniziare i tag; le e commerciali sono usate per denotare entità HTML. Se vuoi usarli come caratteri letterali, devi eseguirne l'escape come entità, ad esempio <, e &.

Le e commerciali in particolare sono fastidiose per i web writer. Se vuoi scrivere su 'AT&T', devi scrivere ' AT&T'. Hai anche bisogno di sfuggire alla e commerciale all'interno degli URL. Quindi, se vuoi collegarti a:

http://images.google.com/images?num=30&q=larry+bird

devi codificare l'URL come:

http://images.google.com/images?num=30&amp;q=larry+bird

nell'attributo del tag di ancoraggio href. Inutile dire che questo è facile da dimenticare ed è probabilmente la singola fonte più comune di errori di convalida HTML in siti Web altrimenti ben contrassegnati.

Markdown ti consente di utilizzare questi personaggi in modo naturale, occupandoti di tutte le evasioni necessarie per te. Se utilizzi una e commerciale come parte di un'entità HTML, rimane invariata; altrimenti verrà tradotto in &.

Quindi, se vuoi includere un simbolo di copyright nel tuo articolo, puoi scrivere:
©
e Markdown lo lascerà in pace. Ma se scrivi:
©

AT&T
Markdown lo tradurrà in:
AT&T
Allo stesso modo, poiché Markdown supporta l'HTML in linea , se utilizzi parentesi angolari come delimitatori per i tag HTML, Markdown li tratterà come tali. Ma se scrivi:

4 < 5
Markdown lo tradurrà in:

4 < 5

Tuttavia, all'interno di intervalli e blocchi di codice Markdown, parentesi angolari e e commerciali sono sempre codificati automaticamente. Ciò semplifica l'utilizzo di Markdown per scrivere codice HTML. (Al contrario dell'HTML grezzo, che è un formato terribile per scrivere sulla sintassi HTML, perché ogni singolo codice <e &nel tuo esempio deve essere sottoposto a escape.)

ELEMENTI DI BLOCCO

PARAGRAFI E INTERRUZIONI DI RIGA

Un paragrafo è semplicemente una o più righe di testo consecutive, separate da una o più righe vuote. (Una riga vuota è qualsiasi riga che assomigli a una riga vuota: una riga contenente nient'altro che spazi o tabulazioni è considerata vuota.) I paragrafi normali non devono essere rientrati con spazi o tabulazioni.

L'implicazione della regola "una o più righe di testo consecutive" è che Markdown supporta i paragrafi di testo "cartonati".
Ciò differisce in modo significativo dalla maggior parte degli altri formattatori da testo a HTML (inclusa l'opzione "Converti interruzioni di riga" di Movable Type) che traducono ogni carattere di interruzione di riga in un paragrafo in un <br />tag.

Quando vuoi inserire un <br />tag di interruzione usando Markdown, chiudi una riga con due o più spazi, quindi digita invio.

Sì, questo richiede un po' più di sforzo per creare una regola <br />, ma una semplicistica "ogni interruzione di riga è una <br />" regola non funzionerebbe per Markdown. Le citazioni in blocco in stile email di Markdown e gli elementi dell'elenco a più paragrafi funzionano meglio - e hanno un aspetto migliore - quando li formatti con interruzioni.

INTESTAZIONI

Markdown supporta due stili di intestazioni, Setext e atx .

Le intestazioni in stile Setext sono "sottolineate" utilizzando segni di uguale (per intestazioni di primo livello) e trattini (per intestazioni di secondo livello). Per esempio:

This is an H1
=============

This is an H1

This is an H2
-------------

This is an H2

Qualsiasi numero di sottolineature =o -di funzionerà.

Le intestazioni in stile Atx utilizzano da 1 a 6 caratteri hash all'inizio della riga, corrispondenti ai livelli di intestazione 1-6. Per esempio:

# This is an H1

## This is an H2

###### This is an H6

Facoltativamente, puoi "chiudere" le intestazioni in stile atx. Questo è puramente estetico: puoi usarlo se pensi che abbia un aspetto migliore. Gli hash di chiusura non devono nemmeno corrispondere al numero di hash utilizzati per aprire l'intestazione. (Il numero di hash di apertura determina il livello di intestazione.) :

# This is an H1 #

## This is an H2 ##

### This is an H3 ######

CITAZIONI IN BLOCCO

Markdown utilizza >caratteri in stile e-mail per le citazioni in blocco. Se hai familiarità con la citazione di passaggi di testo in un messaggio di posta elettronica, allora sai come creare una citazione in blocco in Markdown. Sembra meglio se avvolgi il testo e metti un >prima di ogni riga:

This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.

Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
id sem consectetuer libero luctus adipiscing.
Markdown ti consente di essere pigro e di inserire solo >prima della prima riga di un paragrafo a capo:

This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.

Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
id sem consectetuer libero luctus adipiscing.
I blockquote possono essere annidati (cioè un blockquote-in-a-blockquote) aggiungendo livelli aggiuntivi di >:

This is the first level of quoting.

This is nested blockquote.

Back to the first level.
Blockquotes può contenere altri elementi Markdown, inclusi intestazioni, elenchi e blocchi di codice:

This is a header.

1. This is the first list item.
2. This is the second list item.

Here's some example code:

return shell_exec("echo $input | $markdown_script");

Qualsiasi editor di testo decente dovrebbe semplificare le citazioni in stile e-mail. Ad esempio, con BBEdit, puoi effettuare una selezione e scegliere Aumenta livello preventivo dal menu Testo.

ELENCHI

Markdown supporta elenchi ordinati (numerati) e non ordinati (puntati).

Gli elenchi non ordinati utilizzano asterischi, più e trattini, in modo intercambiabile, come indicatori di elenco:

*   Red
*   Green
*   Blue
è equivalente a:

+   Red
+   Green
+   Blue
e:

-   Red
-   Green
-   Blue
Gli elenchi ordinati utilizzano numeri seguiti da punti:

1.  Bird
2.  McHale
3.  Parish
È importante notare che i numeri effettivi utilizzati per contrassegnare l'elenco non hanno alcun effetto sull'output HTML prodotto da Markdown. L'HTML Markdown prodotto dall'elenco sopra è:

<ol>
<li>Bird</li>
<li>McHale</li>
<li>Parish</li>
</ol>
Se invece hai scritto l'elenco in Markdown in questo modo:

1.  Bird
1.  McHale
1.  Parish
o anche:

3. Bird
1. McHale
8. Parish
otterresti lo stesso identico output HTML. Il punto è che, se lo desideri, puoi utilizzare i numeri ordinali negli elenchi Markdown ordinati, in modo che i numeri nella tua fonte corrispondano ai numeri nel tuo HTML pubblicato. Ma se vuoi essere pigro, non devi.

Se utilizzi la numerazione pigra degli elenchi, tuttavia, dovresti comunque iniziare l'elenco con il numero 1. In futuro, Markdown potrebbe supportare l'avvio di elenchi ordinati con un numero arbitrario.

Gli indicatori di elenco in genere iniziano dal margine sinistro, ma possono essere rientrati fino a tre spazi. Gli indicatori di elenco devono essere seguiti da uno o più spazi o da una tabulazione.

Per rendere gli elenchi belli, puoi avvolgere gli elementi con rientri appesi:

*   Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
    Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
    viverra nec, fringilla in, laoreet vitae, risus.
*   Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
    Suspendisse id sem consectetuer libero luctus adipiscing.
Ma se vuoi essere pigro, non devi:

*   Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
viverra nec, fringilla in, laoreet vitae, risus.
*   Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
Suspendisse id sem consectetuer libero luctus adipiscing.
Se gli elementi dell'elenco sono separati da righe vuote, Markdown racchiude gli elementi nei <p>tag nell'output HTML. Ad esempio, questo input:

*   Bird
*   Magic
si trasformerà in:

<ul>
<li>Bird</li>
<li>Magic</li>
</ul>
Ma questo:

*   Bird

*   Magic
si trasformerà in:

<ul>
<li><p>Bird</p></li>
<li><p>Magic</p></li>
</ul>
Le voci dell'elenco possono essere composte da più paragrafi. Ogni paragrafo successivo in una voce di elenco deve essere rientrato di 4 spazi o di una tabulazione:

1.  This is a list item with two paragraphs. Lorem ipsum dolor
    sit amet, consectetuer adipiscing elit. Aliquam hendrerit
    mi posuere lectus.

    Vestibulum enim wisi, viverra nec, fringilla in, laoreet
    vitae, risus. Donec sit amet nisl. Aliquam semper ipsum
    sit amet velit.

2.  Suspendisse id sem consectetuer libero luctus adipiscing.
Sembra bello se rientri in ogni riga dei paragrafi successivi, ma anche in questo caso, Markdown ti permetterà di essere pigro:

*   This is a list item with two paragraphs.

    This is the second paragraph in the list item. You're
only required to indent the first line. Lorem ipsum dolor
sit amet, consectetuer adipiscing elit.

*   Another item in the same list.
Per inserire un blockquote all'interno di una voce di elenco, i >delimitatori del blockquote devono essere rientrati:

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.
Per inserire un blocco di codice all'interno di una voce di elenco, il blocco di codice deve essere rientrato due volte  : 8 spazi o due schede:

*   A list item with a code block:

        <code goes here>
Vale la pena notare che è possibile attivare un elenco ordinato per errore, scrivendo qualcosa del genere:

1986. What a great season.
In altre parole, una sequenza numero-punto-spazio all'inizio di una riga. Per evitare ciò, puoi eseguire il backslash-escape del punto:

1986\. What a great season.

BLOCCHI DI CODICE

I blocchi di codice preformattati vengono utilizzati per scrivere sulla programmazione o sul codice sorgente di markup.
Invece di formare normali paragrafi, le righe di un blocco di codice vengono interpretate letteralmente.
Markdown esegue il wrapping di un blocco di codice in entrambi i

tag .

Per produrre un blocco di codice in Markdown, è sufficiente far rientrare ogni riga del blocco di almeno 4 spazi o 1 tabulazione.

Ad esempio, dato questo input:
This is a normal paragraph:

    This is a code block.
Markdown genererà:

<p>This is a normal paragraph:</p>

<pre><code>This is a code block.
</code></pre>
Un livello di rientro, 4 spazi o 1 tabulazione, viene rimosso da ciascuna riga del blocco di codice. Ad esempio, questo:

Here is an example of AppleScript:

    tell application "Foo"
        beep
    end tell
si trasformerà in:

<p>Here is an example of AppleScript:</p>

<pre><code>tell application "Foo"
    beep
end tell
</code></pre>
Un blocco di codice continua fino a raggiungere una riga non rientrata (o la fine dell'articolo).