Ciò chì significa Markdown Cumu aduprà a sintassi di Markdown / marcatura di furmatu?

MarkdownCosa significa?

Cumu aduprà a sintassi di Markdown / marcatura di furmatu?

Panoramica

Markdown hè una lingua di marcatura ligera creata da John Gruber.

Permette à e persone di "scrivite documenti in un furmatu di testu chjaru chì hè faciule da leghje è scrive, è poi cunvertisce in documenti XHTML (o HTML) validi".

A lingua incorpora assai di e caratteristiche di u marcatu di testu chjaru chì si trovanu in e-mail.

John Gruber hà criatu a lingua Markdown in u 2004, in cullaburazione cù Aaron Swartz in gran parte nantu à a grammatica.U scopu di a lingua hè d'utilizà "un furmatu di testu chjaru chì hè faciule da leghje, faciule da scrive, è eventualmente cunvertisce in XHTML validu (o HTML)".

scopu

U scopu di Markdown hè di esse "faciule à leghje è faciule da scrive".

leggibilità, fate in ogni moduMarketing Internet, l'esperienza d'utilizatore hè assai impurtante.

Un documentu scrittu in Markdown deve esse publicatu direttamente in testu chjaru, è ùn deve micca esse cumpostu di parechje tag o direttive di furmatu.

A sintassi di Markdown hè influenzata da certi formati di testu à HTML esistenti, cumprese Setext, atx, Textile, reStructuredText, Grutatext, è EtText, ma a più grande fonte d'ispirazione hè u formatu di e-mail di testu chjaru.

In corta, a sintassi di Markdown hè tutta cumpostu di simboli, chì sò selezziunati currettamente è e so funzioni sò chjaru in un sguardu.Per esempiu: mette l'asterischi intornu à u testu per fà cum'è * enfasi *.

Listi in Markdown parevanu, bè, liste. Blockquotes in Markdown parenu veramente cite un pezzu di testu, cum'è avete vistu in e-mail.

Compatibile cù HTML

U scopu di a grammatica Markdown hè di esse una lingua di scrittura per u web.

Markdown ùn hè micca pensatu per rimpiazzà HTML, o ancu avvicinassi, hà assai pochi tipi di sintassi è currisponde à solu un picculu subset di marcatu HTML. Markdown ùn hè micca cuncipitu per fà i documenti HTML più faciuli di scrive.

In u mo parè, HTML hè digià faciule di scrive. L'idea di Markdown hè di fà i documenti più faciule da leghje, scrive è cambià à vuluntà. HTML hè un furmatu di pubblicazione, Markdown hè uncopywritingfurmatu scrittu.Comu tali, a sintassi di furmatu di Markdown copre solu ciò chì u testu chjaru pò.

I tags chì ùn sò micca cuparti da Markdown ponu esse scritti in HTML direttamente in u documentuPromozione Webcopia.Ùn ci hè bisognu di marcà questu cum'è HTML o Markdown; basta aghjunghje u marcatu direttamente.

Solu alcuni elementi di bloccu HTML per esse limitati - cum'è <div>,<table>,<pre>,<p> è altri tags, devenu esse siparati da altri spazii di cuntenutu cù linee in biancu prima è dopu, è e so tag d'apertura è di chjusu ùn ponu micca esse indentate cù tabulazioni o spazii. U generatore Markdown hè abbastanza intelligente per ùn aghjunghje micca tags HTML inutili <p> etichetta.

L'esempiu hè u seguitu, aghjunghjendu una tabella HTML à u schedariu Markdown:

这是一个普通段落。

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

这是另一个普通段落。

Nota chì a sintassi di furmatu Markdown trà e tag di bloccu HTML ùn serà micca trattatu.Per esempiu, se utilizate un stile Markdown in un bloccu HTML*强调*ùn averà micca effettu.

Sezione HTML (inline) tags cum'è <span>,<cite>,<del> Pò esse usatu liberamente in paragrafi, listi o intestazioni di Markdown.Sicondu l'abitudini persunali, pudete ancu aduprà tag HTML per formate senza aduprà u formatu Markdown.Esempiu: Se preferite HTML <a> O <img> tags, chì ponu esse aduprati direttamente senza a sintassi di tag di ligame o di l'imagine furnita da Markdown.

A cuntrariu trà e tag di bloccu HTML, a sintassi di Markdown hè valida trà e tag di sezione HTML.

Cunversione automatica di caratteri speciali

In i schedari HTML, ci sò dui caratteri chì necessitanu un trattamentu speciale: < 和 & . < i simboli sò usati per i tag di partenza,& I simboli sò usati per marcà entità HTML, sè vo vulete solu vede u prototipu di sti caratteri, avete aduprà a forma di entità, cum'è < 和 &.

& I caratteri sò soprattuttu tormentanti per i scrittori di documenti web, se vulete scrive "AT&T", duvete scrive "AT&T".mentri in l'URL & I caratteri sò ancu cunvertiti.Per esempiu, vulete ligà à:

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

Avete da scrive a cunversione URL cum'è:

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

per esse piazzatu in u tag di ligame href in pruprietà.Inutili, questu hè faciule d'ignurà, è probabilmente u più grande numeru di errori rilevati da a validazione di i standard HTML.

Markdown permette di scrive caratteri naturali, è cura di ciò chì deve esse cunvertitu.s'è vo aduprate & Un caratteru hè parti di una entità di caratteri HTML, hè lasciatu cum'è, altrimenti hè cunvertitu &;.

Allora se vulete inserisce un simbulu di copyright in u documentu ©, pudete scrive:

©

Markdown u lascerà intactu.E si scrivi:

AT&T

Markdown u cunvertirà in:

AT&T

Una situazione simili si verifica ancu in < notazione, postu chì Markdown permette a cumpatibilità HTML, se mette < I simboli sò usati cum'è delimitatori per i tag HTML, è Markdown ùn farà micca cunversione nantu à elli, ma se scrive:

4 < 5

Markdown u cunvertirà in:

4 < 5

Tuttavia, deve esse nutatu chì in u scopu di u codice, sia in linea sia in bloccu, < 和 & i dui simbolidevesò cunvertiti in entità HTML, una funzione chì permette di scrive facilmente codice HTML in Markdown (in uppusizione à HTML, induve mette tutti i < 和 & Tutti sò cunvertiti in entità HTML, per scrive codice HTML in u schedariu HTML. )

elementu di bloccu

I paragrafi è i salti di linea

Un paràgrafu Markdown hè custituitu da una o più linee consecutive di testu, precedute è seguitate da più di una linea bianca (a definizione di una linea bianca hè chì pare esse viota nantu à a visualizazione è hè cunsiderata cum'è una linea bianca. esempiu, , se una linea cuntene solu spazii è tabulazioni, a linea serà ancu trattata cum'è una linea bianca).I paragrafi nurmali ùn deve esse indentatu cù spazii o tabulazioni.

A frasa "custituisci di una o più linee consecutive di testu" implica in realtà chì Markdown permette a nova linea forzata (inserimentu di novi linee) in i paragrafi, una funzione chì hè sfarente da a maiò parte di l'altri formati di testu à HTML (cumpresu u tipu Movable "Convertite Line Breaks". "opzione), altri formati cunverteranu ogni interruzione di linea in <br /> etichetta.

Si tùanziVulete confià à Markdown per inserisce <br /> Per l'etichette, appughjà dui o più spazii in u locu di inserimentu è poi appughjà Enter.

Infatti, ci vole un pocu più di travagliu (spazii supplementari) per generà <br /> , ma simpricimenti "ogni newline hè cunvertitu in <br />"U metudu ùn hè micca adattatu in Markdown, em in MarkdownaiI blocchi in stile L è i listi multi-paragrafu ùn sò micca solu più utili, ma ancu più faciuli di leghje quandu si scrivenu cù interruzioni di linea.

Titulu

Markdown supporta duie sintassi per intestazioni, Setext-like è atx-like.

A forma Settext-like hè a forma cù a linea di fondu, usendu = (titulu più altu) è - (Intestazioni di u secondu ordine), per esempiu:

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

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

ogni quantità = 和 - pò esse efficace.

A forma Atx-like inserisce 1 à 6 à u principiu di a linea # , currispundenti à i rubrica 1 à 6, per esempiu:

# 这是 H1

## 这是 H2

###### 这是 H6

Pudete opzionalmente "close" headers atx-like, questu hè puramente per l'estetica, se vi sentite còmode in questu modu, pudete aghjunghje à a fine di a linea. #, mentre chì a fine di a linea # U numeru ùn deve esse u listessu cum'è u principiu (u numeru di caratteri di libbra à u principiu di a linea determina l'ordine di u titulu):

# 这是 H1 #

## 这是 H2 ##

### 这是 H3 ######

Blockquotes Blockquotes

Markdown markup blockquotes sò usati simili à quelli usati in email > di citazioni.Sè avete familiarizatu cù e virgulette in lettere email, sapete cumu creà una citazione di bloccu in un schedariu Markdown, chì parerebbe chì rompe e linee stessu, poi aghjunghje. > :

> 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 permette ancu di esse pigra è aghjunghje solu a prima linea di tuttu u paràgrafu > :

> 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 riferimenti di blocchi ponu esse annidati (per esempiu: riferimenti in riferimenti) aghjunghjendu un numeru sfarente di > :

> This is the first level of quoting.
>
> > This is nested blockquote.
>
> Back to the first level.

Altre sintassi di Markdown ponu ancu esse aduprate in i blocchi citati, cumprese intestazioni, listi, blocchi di codice, etc.:

> ## 这是一个标题。
> 
> 1.   这是第一行列表项。
> 2.   这是第二行列表项。
> 
> 给出一些例子代码：
> 
>     return shell_exec("echo $input | $markdown_script");

Qualchese editore di testu decentu pò facilmente creà citazioni in stile email.Per esempiu, in BBEdit pudete selezziunà u testu è poi sceglie da u menùaumentà a gerarchia di citazioni.

Elencu

Markdown supporta listi urdinati è micca ordinati.

Listi senza ordine utilizanu asterischi, segni più, o segni minus cum'è marcatori di lista:

*   Red
*   Green
*   Blue

Equivalente à:

+   Red
+   Green
+   Blue

Equivalente ancu à:

-   Red
-   Green
-   Blue

Listi urdinati utilizanu numeri seguiti da un periodu:

1.  Bird
2.  McHale
3.  Parish

Hè impurtante di nutà chì i numeri chì aduprate nantu à l'etichetta di a lista ùn affettanu micca l'HTML di output. U marcatu HTML resultante per a lista suprana seria:

<ol>
<li>Bird</li>
<li>McHale</li>
<li>Parish</li>
</ol>

Se u vostru marcatu di lista hè scrittu cum'è:

1.  Bird
1.  McHale
1.  Parish

o ancu:

3. Bird
1. McHale
8. Parish

Truverete tramindui esattamente u listessu output HTML.U puntu hè, pudete fà i numeri di lista in u schedariu Markdown u listessu cum'è i risultati di a pruduzzioni, o sè vo site pigra, ùn avete micca bisognu di cura di a correttezza di i numeri.

Sè vo aduprate scrittura lazy, hè cunsigliatu di principià cù 1. per u primu articulu, perchè Markdown pò sustene l'attributu iniziale di listi urdinati in u futuru.

L'etichetta di l'elementu di a lista hè generalmente posta à l'estrema sinistra, ma pò esse indentata, finu à 3 spazii, è l'etichetta di l'articulu deve esse seguita da almenu un spaziu o tabulazione.

Per fà a lista più bella, pudete urganizà u cuntenutu cù un indentu fissu:

*   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 s'è vo site pigro, hè ancu bè:

*   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 l'articuli di u listinu sò siparati da linee in biancu, Markdown utilizerà u cuntenutu di l'elementu quandu pruduce HTML. <p> L'etichette sò imballate, per esempiu:

*   Bird
*   Magic

serà cunvertitu in:

<ul>
<li>Bird</li>
<li>Magic</li>
</ul>

Ma questu:

*   Bird

*   Magic

serà cunvertitu in:

<ul>
<li><p>Bird</p></li>
<li><p>Magic</p></li>
</ul>

L'articuli di a lista ponu cuntene parechji paragrafi, è i paragrafi sottu à ogni articulu deve esse indentatu da 4 spazii o 1 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 assai megliu se indentate ogni linea, sicuru, di novu, sè vo site pigro, Markdown permette ancu:

*   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.

Se vulete mette una riferenza in un articulu di lista, allora > Hè bisognu à esse indentatu:

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

Se vulete mette un bloccu di codice, u bloccu deve esse indentatuduie volte, chì hè 8 spazii o 2 tabulazioni:

*   一列表项包含一个列表区块：

        <代码写在这>

Di sicuru, una lista di l'articuli puderia esse generata accidentalmente, qualcosa cum'è questu:

1986. What a great season.

In altri palori, appare à u principiu di a lineanumeru-periodu-biancu, Per evitari questu, pudete aghjunghje un backslash prima di u periodu.

1986\. What a great season.

bloccu codice

U codice fonte di scrittura in u prugramma o di lingua di tag di solitu hà digià blocchi di codice cumposti. Di solitu, ùn vulemu micca questi blocchi per esse cumposti in u modu di i schedarii di paragrafi generale, ma vedeli cum'è sò. Markdown aduprà. <pre> 和 <code> etichette per imballare i blocchi di codice.

I blocchi di codice in Markdown sò simplici cum'è indentà 4 spazii o 1 tabulazione, per esempiu, entre in i seguenti:

这是一个普通段落：

    这是一个代码区块。

Markdown si cunvertirà in:

<p>这是一个普通段落：</p>

<pre><code>这是一个代码区块。
</code></pre>

Questa indentazione di primu ordine per linea (4 spazii o 1 tabulazione) hè eliminata, per esempiu:

Here is an example of AppleScript:

    tell application "Foo"
        beep
    end tell

serà cunvertitu in:

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

<pre><code>tell application "Foo"
    beep
end tell
</code></pre>

Un bloccu di codice cuntinueghja finu à a linea unindented (o a fine di u schedariu).

Dentru u bloccu di codice, & , < 和 > Serà automaticamente cunvertitu in entità HTML. Stu metudu rende assai faciule d'utilizà Markdown per inserisce u codice fonte HTML per l'esempiu, basta copià è incollà, aghjunghje indentazione, è u restu Markdown hà da trattà per voi, per esempiu:

    <div class="footer">
        © 2004 Foo Corporation
    </div>

serà cunvertitu in:

<pre><code><div class="footer">
    © 2004 Foo Corporation
</div>
</code></pre>

In u bloccu di codice, a sintassi generale di Markdown ùn serà micca cunvertita, cum'è l'asterischi sò solu asterischi, chì significa chì pudete scrive facilmente i schedarii di sintassi Markdown in sintassi Markdown.

divisore

Pudete creà un divisore cù più di trè asterischi, minus signs, underscores in una linea, nunda di più in a linea.Pudete ancu inserisce spazii trà asterischi o segni minus.I linii di separazione ponu esse creati in ognuna di e seguenti modi di scrittura:

* * *

***

*****

- - -

---------------------------------------

Elementu di a sezione

ligame

Markdown supporta duie forme di sintassi di ligame: In linea和Riferimentuduie forme.

In ogni modu, u testu di ligame hè marcatu cù [parentesi quadrati].

per creà aIn lineaSe vulete aghjunghje u testu di tìtulu di u ligame, fate solu u testu di u titulu cù virgulette doppie dopu l'URL, per esempiu:

This is [an example](http://example.com/ "Title") inline link.

[This link](http://example.net/) has no title attribute.

Prudurà:

<p>This is <a href="http://example.com/" title="Title">
an example</a> inline link.</p>

<p><a href="http://example.net/">This link</a> has no
title attribute.</p>

Sè site in ligame cù risorse nantu à u stessu host, pudete aduprà percorsi relative:

See my [About](/about/) page for details.

RiferimentuU ligame hè seguitu da un altru parentesi dopu à u parentesi di u testu di u ligame, è a marca utilizata per identificà u ligame deve esse cumpletu in u sicondu parentesi quadratu:

This is [an example][id] reference-style link.

Pudete ancu opzionalmente mette un spaziu trà i dui parentesi quadrate:

This is [an example] [id] reference-style link.

Allora, in ogni locu in u schedariu, pudete definisce u cuntenutu di u ligame di sta tag:

[id]: http://example.com/  "Optional Title Here"

U cuntenutu di u ligame hè definitu in a forma:

• Parentesi quadrate (opcionalmente precedute da finu à trè spazii per indentazione) in quale hè inseritu u testu di ligame
• seguita da un colon
• seguita da unu o più spazii o tabulazioni
• l'URL di u prossimu ligame
• Opzionalmente, seguite u cuntenutu di u titulu, chì pò esse chjusu in virgulette singuli, virgulette doppie o parentesi

E definizioni di i trè ligami seguenti sò listessi:

[foo]: http://example.com/  "Optional Title Here"
[foo]: http://example.com/  'Optional Title Here'
[foo]: http://example.com/  (Optional Title Here)

请 注意 ：Ci hè un prublema cunnisciutu induve Markdown.pl 1.0.1 ignora i tituli di ligami chjusi in virgulette singuli.

L'URL di ligami ponu ancu esse chjusi in parentesi angulari:

[id]: <http://example.com/>  "Optional Title Here"

Pudete ancu mette l'attributu di tìtulu nantu à a linea dopu, o aghjunghje qualchì indentazione, chì parerà megliu se l'URL hè troppu longu:

[id]: http://example.com/longish/path/to/resource/here
    "Optional Title Here"

A definizione di l'URL hè aduprata solu quandu generà u ligame, è ùn appare micca direttamente in u schedariu.

I tags d'identificazione di u ligame ponu cuntene lettere, numeri, spazii bianchi è puntuazione, ma miccaMiccaHè sensible à u casu, cusì i seguenti dui ligami sò listessi:

[link text][a]
[link text][A]

Tag di ligame implicituA funzione permette di omette di specificà un tag di ligame. In questu casu, u tag di ligame serà trattatu cum'è equivalente à u testu di u ligame. Per utilizà un tag di ligame implicitu, aghjunghje solu un parentesi quadratu viotu dopu à u testu di u ligame. Se vulete "Google "Ligà à google.com, pudete simplificà per:

[Google][]

Allora definisce u cuntenutu di u ligame:

[Google]: http://google.com/

Siccomu u testu di ligame pò cuntene spazii bianchi, stu marcatu simplificatu pò cuntene parechje parolle:

Visit [Daring Fireball][] for more information.

Allora vai à definisce u ligame:

[Daring Fireball]: http://daringfireball.net/

A definizione di u ligame pò esse piazzatu in ogni locu in u schedariu. Preferite mette direttamente dopu à u paràgrafu induve u ligame appare.Pudete ancu mette à a fine di u schedariu, cum'è un cumentu.

Eccu un esempiu di un ligame di riferimentu:

I get 10 times more traffic from [Google] [1] than from
[Yahoo] [2] or [MSN] [3].

  [1]: http://google.com/        "Google"
  [2]: http://search.yahoo.com/  "Yahoo Search"
  [3]: http://search.msn.com/    "MSN Search"

Se cambiassi per aduprà u nome di u ligame per scrive:

I get 10 times more traffic from [Google][] than from
[Yahoo][] or [MSN][].

  [google]: http://google.com/        "Google"
  [yahoo]:  http://search.yahoo.com/  "Yahoo Search"
  [msn]:    http://search.msn.com/    "MSN Search"

I dui modi di scrive sopra pruducianu u seguente HTML.

<p>I get 10 times more traffic from <a href="http://google.com/"
title="Google">Google</a> than from
<a href="http://search.yahoo.com/" title="Yahoo Search">Yahoo</a>
or <a href="http://search.msn.com/" title="MSN Search">MSN</a>.</p>

Quì sottu hè un schedariu Markdown di u listessu cuntenutu scrittu in linea, furnitu per paragone:

I get 10 times more traffic from [Google](http://google.com/ "Google")
than from [Yahoo](http://search.yahoo.com/ "Yahoo Search") or
[MSN](http://search.msn.com/ "MSN Search").

In fatti, u puntu di ligami in stile di riferimentu ùn hè micca chì hè più faciule di scrive, ma chì hè più faciule da leghje. Paragunate l'esempiu di sopra. L'articulu di stile di riferimentu stessu hè solu 81 caratteri, ma a forma in linea aumenterà à Caratteri 176. , S'ellu hè scrittu in formatu HTML puru, ci saranu caratteri 234. In u formatu HTML, ci sò più tags cà testu.

Utilizendu i ligami in u stilu di riferimentu di Markdown, pudete fà u documentu più cum'è u risultatu finali di u navigatore, chì permette di trasfurmà qualchì metadata di marcatura fora di u testu di u paràgrafu, è pudete aghjunghje ligami senza fà a sensazione di lettura di l'articulu. .

Enfatizà

Markdown usa asterischi (*) è a linea di fondu (_) cum'è un simbulu per marcà una parolla sottolineata, hè * O _ E parolle circundate sò cunvertite <em> circundatu da etichette, cù dui * O _S'ellu hè imballatu, serà cunvertitu in <strong>, Per esempiu:

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

si trasformerà in:

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

Pudete aduprà qualsiasi stile chì vulete, l'unica limitazione hè chì pudete apre u tag cù quale simbulu vulete finisce.

L'enfasi pò ancu esse inserita direttamente à mezu à u testu:

un*frigging*believable

masì u vostru * 和 _ Se ci sò spazii bianchi da i dui lati, sò trattati solu cum'è simboli normali.

Per inserisce asterischi normali o underscores direttamente prima è dopu u testu, pudete aduprà backslashes:

\*this text is surrounded by literal asterisks\*

Codice

Se vulete marcà un picculu pezzu di codice in linea, pudete imballà in backticks (`), per esempiu:

Use the `printf()` function.

Prudurà:

<p>Use the <code>printf()</code> function.</p>

Se vulete inserisce backticks in una sezione di codice, pudete inizià è finisce a sezione di codice cù parechje backticks:

``There is a literal backtick (`) here.``

Questa sintassi produce:

<p><code>There is a literal backtick (`) here.</code></p>

Pudete mette un biancu à u principiu è a fine di una sezione di codice, unu dopu à u principiu è unu prima di a fine, cusì pudete inserisce backticks à u principiu di a sezione:

A single backtick in a code span: `` ` ``

A backtick-delimited string in a code span: `` `foo` ``

Prudurà:

<p>A single backtick in a code span: <code>`</code></p>

<p>A backtick-delimited string in a code span: <code>`foo`</code></p>

Dentru a sezione di codice,& e parentesi angolari都serà automaticamente cunvertitu in entità HTML, chì facilita l'inserzione di codice fonte HTML, Markdown metterà u paragrafu seguente:

Please don't use any `<blink>` tags.

à:

<p>Please don't use any <code><blink></code> tags.</p>

Pudete ancu scrive questu:

`—` is the decimal-encoded equivalent of `—`.

Per pruduce:

<p><code>—</code> is the decimal-encoded
equivalent of <code>—</code>.</p>

Picture

Ovviamente, hè difficiule di disignà una sintassi "naturale" per inserisce l'imaghjini in una applicazione solu di testu.

Markdown usa una sintassi simile à quella di i ligami per marcà l'imagine, è permette ancu dui stili: In linea和Riferimentu.

A sintassi di l'imaghjini in linea hè simile à:

![Alt text](/path/to/img.jpg)

![Alt text](/path/to/img.jpg "Optional title")

I dettagli sò i seguenti:

• un puntu d'esclamazione !
• seguita da un parentesi quadratu cù u testu alt per l'imaghjini
• Questu hè seguitatu da parentesi normali cù l'URL di l'imaghjini, è infine un testu opzionale "titulu" chjusu in virgulette.

A sintassi di l'imaghjini di riferimentu hè cusì:

![Alt text][id]

"id" hè u nome di a riferenza di l'imaghjini, chì hè definitu in u listessu modu cum'è una riferenza di ligame:

[id]: url/to/image  "Optional title attribute"

Finu a ora, Markdown ùn hà micca manera di specificà a larghezza è l'altezza di l'imaghjini, se avete bisognu, pudete aduprà u normale. <img> etichetta.

其它

ligame automaticu

Markdown supporta l'elaborazione di l'URL è e caselle di e-mail in forma di ligami automatichi relativamente brevi. Sempre ch'elli sò chjusi in parentesi angulari, Markdown a cunvertisce automaticamente in un ligame.U testu di ligame di l'URL generale hè u listessu cum'è l'indirizzu di ligame, per esempiu:

<http://example.com/>

Markdown serà cunvertitu in:

<a href="http://example.com/">http://example.com/</a>

U ligame automaticu di l'indirizzi email hè ancu assai simili, salvu chì Markdown prima eseguirà un prucessu di cunversione di codificazione, cunvertisce caratteri di testu in entità HTML esadecimali. Stu furmatu pò ingannà certi roboti di cullizzioni d'indirizzi email, cum'è:

<[email protected]>

Markdown si trasformerà in:

<a href="mailto:addre
[email protected]
m">address@exa
mple.com</a>

In u navigatore, sta stringa (in realtà <a href="mailto:[email protected]">[email protected]</a>) diventa un ligame "[email protected]" clicable.

(Ancu chì questu approcciu pò ingannà assai robots, ùn pò micca impediscenu tutti, ma hè megliu cà nunda. In ogni casu, apre u vostru mailbox eventualmente attrae lettere di publicità).

backslash

Markdown pò usà backslashes per inserisce simboli chì anu altri significati in a grammatica, per esempiu: se vulete aghjunghje un asteriscu accantu à u testu per enfasi (ma micca <em> tag), pudete precede l'asteriscu cù un backslash:

\*literal asterisks\*

Markdown supporta i seguenti simboli preceduti da un backslash per aiutà à inserisce simboli cumuni:

\   反斜线
`   反引号
*   星号
_   底线
{}  花括号
[]  方括号
()  括弧
#   井字号
+   加号
-   减号
.   英文句点
!   惊叹号

Editore gratuitu di Markdown

piattaforma Windows

• MarkdownPad
• MarkPad

piattaforma Mac

• chjara

editore in linea

• MPEditor

plugin di navigatore

• Markdown quì plugin

*** Se ci hè un editore Markdown gratuitu megliu da ricumandà, fate attenzione à i feedbackChen Weiliang,Grazie!