Xi jfisser Markdown? Kif tuża l-markup tas-sintassi/format ta' Markdown?

MarkdownXi jfisser?

Kif tuża l-markup tas-sintassi/format ta' Markdown?

Ħarsa ġenerali

Markdown hija lingwaġġ ta' markup ħafif maħluqa minn John Gruber.

Jippermetti lin-nies "jikteb dokumenti f'format ta' test sempliċi li huwa faċli biex jinqara u jiktbu, u mbagħad jaqilbuhom f'dokumenti XHTML (jew HTML) validi".

Il-lingwa assorbiet ħafna mill-karatteristiċi tal-markup tat-test sempliċi diġà misjuba fl-email.

John Gruber ħoloq il-lingwa Markdown fl-2004, b'kollaborazzjoni ma' Aaron Swartz fil-biċċa l-kbira fuq is-sintassi.L-iskop tal-lingwa huwa li tuża "format ta' test sempliċi li huwa faċli biex jinqara, faċli biex tikteb, u b'għażla jikkonverti f'XHTML validu (jew HTML)".

għan

L-għan ta 'Markdown huwa li jinkiseb "faċli biex jinqara u faċli biex tikteb".

leġibbiltà, agħmel dan xorta waħda网络 营销, l-esperjenza tal-utent hija importanti ħafna.

Fajl miktub f'Markdown għandu jkun jista' jiġi ppubblikat direttament f'test sempliċi, u m'għandux jidher li jikkonsisti f'ħafna tags jew direttivi tal-ifformattjar.

Is-sintassi ta’ Markdown hija influwenzata minn xi formati eżistenti minn test għal HTML, inklużi Setext, atx, Textile, reStructuredText, Grutatext, u EtText, iżda l-akbar sors ta’ ispirazzjoni huwa l-format tal-email b’test sempliċi.

Fil-qosor, is-sintassi ta 'Markdown hija kollha komposta minn simboli, li huma magħżula bir-reqqa u l-funzjonijiet tagħhom huma ċari f'daqqa t'għajn.Pereżempju: poġġi l-asterisks madwar it-test biex jidher qisu *enfasi*.

Listi f'Markdown jidhru bħal, ukoll, listi. Blockquotes f'Markdown verament qishom jikkwotaw biċċa test, bħalma rajt fl-emails.

Kompatibbli ma 'HTML

L-għan tal-grammatika Markdown huwa li tkun lingwa tal-kitba għall-web.

Markdown mhuwiex maħsub biex jissostitwixxi HTML, jew saħansitra jersaq qrib tiegħu, għandu sintassi ftit li xejn u jikkorrispondi għal subsett żgħir biss ta 'markup HTML. Markdown ma kienx maħsub biex jagħmel id-dokumenti HTML aktar faċli biex jinkitbu.

Fl-opinjoni tiegħi, HTML huwa diġà faċli biex tikteb. L-idea ta 'Markdown hija li tagħmel id-dokumenti eħfef biex jinqraw, jinkitbu, u jinbidlu kif riedu. HTML huwa format ta 'pubblikazzjoni, Markdown huwa aKitbaformat bil-miktub.Bħala tali, is-sintassi tal-ifformattjar ta' Markdown tkopri biss dak li jista' test sempliċi.

Tikketti li mhumiex koperti minn Markdown jistgħu jinkitbu f'HTML direttament fid-dokumentPromozzjoni tal-Webkopja.M'hemmx għalfejn timmarka dan bħala HTML jew Markdown; żid il-markup direttament.

Xi elementi tal-blokk HTML biss għandhom jiġu ristretti - bħal <div>,<table>,<pre>,<p> u tikketti oħra, għandhom ikunu separati minn żoni oħra ta 'kontenut b'linji vojta qabel u wara, u t-tikketti tal-ftuħ u tal-għeluq tagħhom m'għandhomx ikunu indentjati b'tabs jew spazji. Il-ġeneratur Markdown huwa intelliġenti biżżejjed biex ma jżidx tikketti tal-blokk HTML bla bżonn <p> tikketta.

L-eżempju huwa kif ġej, billi żżid tabella HTML mal-fajl Markdown:

这是一个普通段落。

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

这是另一个普通段落。

Innota li s-sintassi tal-ifformattjar ta' Markdown bejn it-tikketti tal-blokk HTML mhux se tiġi pproċessata.Per eżempju, jekk tuża stil Markdown ġewwa blokka HTML*强调*ma jkollu ebda effett.

Sezzjoni HTML (inline) tags bħal <span>,<cite>,<del> Jistgħu jintużaw liberament fil-paragrafi Markdown, listi jew intestaturi.Skont id-drawwiet personali, tista 'anki tuża tikketti HTML biex tifformattja mingħajr ma tuża l-format Markdown.Eżempju: Jekk tippreferi HTML <a> Jew <img> tikketti, li jistgħu jintużaw direttament mingħajr il-link jew is-sintassi tat-tikketta tal-immaġni pprovduti minn Markdown.

B'differenza bejn it-tikketti tal-blokk HTML, is-sintassi ta' Markdown hija valida bejn it-tikketti tas-sezzjoni HTML.

Konverżjoni awtomatika ta 'karattri speċjali

Fil-fajls HTML, hemm żewġ karattri li jeħtieġu tqandil speċjali: < 和 & . < is-simboli jintużaw għat-tikketti tal-bidu,& Is-simboli jintużaw biex jimmarkaw entitajiet HTML, jekk trid biss turi l-prototip ta 'dawn il-karattri, trid tuża l-forma tal-entità, bħal < 和 &.

& Il-karattri huma speċjalment itturmentanti għall-kittieba tad-dokumenti tal-web, jekk se ttajpja "AT&T", trid tikteb "AT&T".filwaqt li fil-URL & Karattri huma wkoll konvertiti.Per eżempju trid tingħaqad ma':

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

Int trid tikteb il-konverżjoni tal-URL bħala:

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

biex jitqiegħed fit-tikketta tal-link href fi proprjetajiet.M'għandniex xi ngħidu, dan huwa faċli biex jiġi injorat, u probabbilment l-akbar numru ta 'żbalji misjuba mill-validazzjoni tal-istandards HTML.

Markdown jippermettilek tikteb karattri b'mod naturali, u jieħu ħsieb dak li jeħtieġ li jiġi kkonvertit.jekk tuża & Karattru huwa parti minn entità ta 'karattri HTML, jitħalla kif inhu, inkella jiġi kkonvertit għal &;。

Mela jekk trid daħħal simbolu tad-drittijiet tal-awtur fid-dokument ©, tista' tikteb:

©

Markdown se jħalli mhux mittiefsa.U jekk tikteb:

AT&T

Markdown jikkonvertih għal:

AT&T

Sitwazzjoni simili sseħħ ukoll fi < notazzjoni, peress li Markdown jippermetti kompatibilità HTML, jekk tpoġġi < Is-simboli jintużaw bħala delimitaturi għat-tikketti HTML, u Markdown ma jagħmel l-ebda konverżjoni fuqhom, imma jekk tikteb:

4 < 5

Markdown jikkonvertih għal:

4 < 5

Madankollu, għandu jiġi nnutat li fl-ambitu tal-kodiċi, kemm jekk huwa inline jew blokk, < 和 & iż-żewġ simboli一定huma kkonvertiti f'entitajiet HTML, karatteristika li tippermettilek tikteb faċilment kodiċi HTML f'Markdown (kuntrarju għal HTML, fejn tpoġġi l-kodiċi kollha < 和 & Kollha huma kkonvertiti f'entitajiet HTML, sabiex tikteb kodiċi HTML fil-fajl HTML. )

element blokk

Paragrafi u qtugħ ta' linji

Paragrafu Markdown jikkonsisti f'linja waħda jew aktar ta' test konsekuttivi, preċeduti u segwiti minn aktar minn linja vojta waħda (id-definizzjoni ta' linja vojta hija li tidher vojta fuq il-wiri u titqies bħala linja vojta. Per eżempju, , jekk linja fiha biss spazji u tabs, il-linja tiġi ttrattata wkoll bħala linja vojta).Il-paragrafi normali m'għandhomx ikunu indentjati bi spazji jew tabs.

Il-frażi "jikkonsisti f'linja waħda jew aktar ta' test konsekuttivi" fil-fatt timplika li Markdown jippermetti qtugħ ta' linji sfurzati (inserzjoni ta' linji ġodda) fi ħdan il-paragrafi, karatteristika li hija differenti mill-biċċa l-kbira tal-formati oħra ta' test għal HTML (inkluż it-Tip Movabbli "Konverti Linja" Pawżi "għażla), formati oħra se jikkonvertu kull waqfa tal-linja għal <br /> tikketta.

Jekk inttabilħaqqTrid tistrieħ fuq Markdown biex tiddaħħal <br /> Għat-tikketti, agħfas żewġ spazji jew aktar fil-post tal-inserzjoni u mbagħad agħfas Enter.

Tabilħaqq, jeħtieġ ftit aktar xogħol (spazji addizzjonali) biex tiġġenera <br /> , iżda sempliċement "kull linja ġdida hija kkonvertita għal <br />"Il-metodu mhuwiex adattat f'Markdown, em f'MarkdownaiIl-blockquotes ta' stil L u l-listi b'ħafna paragrafi mhumiex biss aktar utli iżda wkoll aktar faċli biex jinqraw meta jitfasslu b'pawżi tal-linji.

Titlu

Markdown jappoġġja żewġ sintassi għall-intestaturi, bħal Setext u bħal atx.

Il-formola Settext-like hija l-formola mal-linja tal-qiegħ, bl-użu = (l-ogħla titolu) u - (Intestaturi tat-tieni ordni), pereżempju:

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

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

kwalunkwe ammont = 和 - jistgħu jkunu effettivi.

Il-forma li tixbah lil Atx tiddaħħal 1 sa 6 fil-bidu tal-linja # , li jikkorrispondu għall-intestaturi 1 sa 6, pereżempju:

# 这是 H1

## 这是 H2

###### 这是 H6

Tista 'b'għażla "tagħlaq" headers simili atx, dan huwa purament għall-estetika, jekk tħossok komdu b'dan il-mod, tista' żżidha fl-aħħar tal-linja #, filwaqt li t-truf tal-linja # In-numru m'għandux għalfejn ikun l-istess bħall-bidu (in-numru ta' karattri lira fil-bidu tal-linja jiddetermina l-ordni tat-titlu):

# 这是 H1 #

## 这是 H2 ##

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

Blockquotes Blockquotes

Il-kwoti imblukkar tal-markdown tal-markdown jintużaw simili għal dawk użati fl-email > taċ-ċitazzjonijiet.Jekk int familjari mal-kwotazzjonijiet f'ittri bl-email, taf kif toħloq kwotazzjoni blokka f'fajl Markdown, li tkun qisha tikser il-linji lilek innifsek, imbagħad żid > :

> 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 jippermettilek ukoll li tkun għażżien u żid biss l-ewwel linja tal-paragrafu kollu > :

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

Ir-referenzi tal-blokki jistgħu jiġu mdaħħla (eż.: referenzi f'referenzi) billi jiżdied numru differenti ta' > :

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

Sintassi oħra ta' Markdown jistgħu jintużaw ukoll fi ħdan blokki kkwotati, inklużi intestaturi, listi, blokki ta' kodiċi, eċċ.:

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

Kwalunkwe editur tat-test deċenti jista 'faċilment joħloq ċitazzjonijiet ta' stil ta 'email.Pereżempju f'BBEdit tista' tagħżel it-test u mbagħad tagħżel mill-menuiżżid il-ġerarkija taċ-ċitazzjoni.

Lista

Markdown jappoġġja listi ordnati u mhux ordnati.

Listi mhux ordnati jużaw asterisks, sinjali biż-żieda, jew sinjali minus bħala markaturi tal-lista:

*   Red
*   Green
*   Blue

Ekwivalenti għal:

+   Red
+   Green
+   Blue

Ekwivalenti wkoll għal:

-   Red
-   Green
-   Blue

Listi ordnati jużaw numri segwiti minn perjodu:

1.  Bird
2.  McHale
3.  Parish

Huwa importanti li wieħed jinnota li n-numri li tuża fuq it-tikketta tal-lista ma jaffettwawx l-output HTML. Il-markup HTML li jirriżulta għal-lista ta' hawn fuq ikun:

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

Jekk il-markup tal-lista tiegħek huwa miktub bħala:

1.  Bird
1.  McHale
1.  Parish

jew saħansitra:

3. Bird
1. McHale
8. Parish

It-tnejn ikollok eżattament l-istess output HTML.Il-punt hu, inti tista 'tagħmel in-numri tal-lista fil-fajl Markdown l-istess bħar-riżultati tal-output, jew jekk int għażżien, m'għandekx bżonn tieħu ħsieb il-korrettezza tan-numri għal kollox.

Jekk tuża kitba għażżien, huwa rakkomandat li tibda b'1. għall-ewwel oġġett, minħabba li Markdown jista 'jappoġġja l-attribut tal-bidu ta' listi ordnati fil-futur.

It-tikketta tal-oġġett tal-lista normalment titqiegħed fuq ix-xellug, iżda tista 'tiġi indentata, sa 3 spazji, u t-tikketta tal-oġġett trid tkun segwita minn tal-inqas spazju jew tab wieħed.

Biex tagħmel il-lista tidher aktar sabiħa, tista 'torganizza l-kontenut b'inċiż fiss:

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

Imma jekk int għażżien, tajjeb ukoll:

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

Jekk l-oġġetti tal-lista huma separati minn linji vojta, Markdown juża l-kontenut tal-oġġett meta joħroġ HTML. <p> It-tikketti huma mgeżwra, pereżempju:

*   Bird
*   Magic

se jiġi kkonvertit għal:

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

Imma dan:

*   Bird

*   Magic

se jiġi kkonvertit għal:

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

L-oġġetti tal-lista jista' jkun fihom paragrafi multipli, u l-paragrafi taħt kull oġġett iridu jkunu indentjati b'4 spazji jew tab 1:

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.

Jidher ħafna aħjar jekk tagħmel inċiż f'kull linja, ovvjament, għal darb'oħra, jekk int għażżien, Markdown jippermetti wkoll:

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

Jekk trid tpoġġi referenza ġewwa oġġett tal-lista, allura > Jeħtieġ li jkun indentjat:

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

Jekk trid tpoġġi blokk tal-kodiċi, il-blokk jeħtieġ li jkun indentjatdarbtejn, li hija 8 spazji jew 2 tabs:

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

        <代码写在这>

Naturalment, lista ta 'oġġetti tista' tiġi ġġenerata aċċidentalment, xi ħaġa bħal din:

1986. What a great season.

Fi kliem ieħor, jidher fil-bidu tal-linjanumru-perjodu-vojt, biex tevita dan, tista 'żżid backslash qabel il-perjodu.

1986\. What a great season.

blokk tal-kodiċi

Il-kodiċi tas-sors tal-kitba jew tal-lingwa tat-tikketti relatata mal-programm normalment ikollu diġà blokki ta' kodiċi mfasslin. Normalment, ma rridux li dawn il-blokki jiġu mfasslin bil-forma ta' fajls ta' paragrafi ġenerali, iżda nuruhom kif inhuma. Markdown juża <pre> 和 <code> tikketti biex ikebbew blokki tal-kodiċi.

Il-blokki tal-kodiċi tal-bini f'Markdown huwa sempliċi daqs 4 spazji jew 1 tab, per eżempju, daħħal dan li ġej:

这是一个普通段落：

    这是一个代码区块。

Markdown se jikkonverti għal:

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

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

Din l-indentazzjoni tal-ewwel ordni għal kull linja (4 spazji jew tab 1) titneħħa, pereżempju:

Here is an example of AppleScript:

    tell application "Foo"
        beep
    end tell

se jiġi kkonvertit għal:

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

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

Blokk ta' kodiċi jkompli sal-linja mhux indentata (jew tmiem il-fajl).

Ġewwa l-blokka tal-kodiċi, & , < 和 > Se jiġi kkonvertit awtomatikament f'entitajiet HTML, li jagħmilha faċli ħafna għalik li tuża Markdown biex daħħal il-kodiċi tas-sors HTML għall-eżempju, tikkopjaha u tippejstjaha, żid indentazzjoni, u l-bqija tal-Markdown se tieħu ħsiebha għalik, pereżempju:

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

se jiġi kkonvertit għal:

<pre><code><div class="footer">
    &copy; 2004 Foo Corporation
</div>
</code></pre>

Fil-blokk tal-kodiċi, is-sintassi ġenerali Markdown mhux se tiġi kkonvertita, bħal asterisks huma biss asterisks, li jfisser li tista 'faċilment tikteb fajls relatati mas-sintassi Markdown fis-sintassi Markdown.

diviżur

Tista 'tuża aktar minn tliet asterisks, sinjali minus, underscores biex toħloq diviżur f'linja, xejn aktar fil-linja.Tista' wkoll daħħal spazji bejn asterisks jew sinjali minus.Linji ta' separazzjoni jistgħu jinħolqu f'kull wieħed mill-modi ta' kitba li ġejjin:

* * *

***

*****

- - -

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

element tas-sezzjoni

Rabta

Markdown jappoġġja żewġ forom ta' sintassi tal-link: F'konformità和Referenzażewġ forom.

Jew il-mod, it-test tal-link huwa mmarkat b'[parentesi kwadri].

biex toħloq aF'konformitàJekk trid iżżid it-test tat-titlu tal-link, daħħal it-test tat-titlu b'virgoletti doppji wara l-URL, pereżempju:

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

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

Se tipproduċi:

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

Jekk qed tgħaqqad ma' riżorsi fuq l-istess host, tista' tuża mogħdijiet relattivi:

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

ReferenzaIr-rabta hija segwita minn parentesi kwadra oħra wara l-parentesi tat-test tal-link, u l-marka użata biex tidentifika l-link għandha timtela fit-tieni parentesi kwadra:

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

Tista' wkoll b'għażla tpoġġi spazju bejn iż-żewġ parentesi kwadri:

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

Imbagħad, kullimkien fil-fajl, tista 'tiddefinixxi l-kontenut tal-link ta' din it-tikketta:

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

Il-kontenut tal-link huwa definit fil-forma:

• Parentesi kwadri (b'għażla preċeduti minn sa tliet spazji għall-indentazzjoni) li fihom jiddaħħal it-test tal-link
• segwit minn kolon
• segwit minn spazju jew tabs wieħed jew aktar
• il-URL tal-link li jmiss
• B'għażla segwi l-kontenut tat-titlu, li jista' jkun magħluq fi kwotazzjonijiet singoli, kwotazzjonijiet doppji, jew parentesi

Id-definizzjonijiet tat-tliet links li ġejjin huma l-istess:

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

prudenza:Hemm kwistjoni magħrufa fejn Markdown.pl 1.0.1 jinjora t-titli tal-links magħluqa fi kwotazzjonijiet singoli.

URLs tal-links jistgħu wkoll ikunu magħluqa f'parentesi angolari:

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

Tista' wkoll tpoġġi l-attribut tat-titlu fil-linja li jmiss, jew iżżid xi indentazzjoni, li tidher aħjar jekk il-URL ikun twil wisq:

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

Id-definizzjoni tal-URL tintuża biss meta tiġġenera l-link, u ma tidhirx direttament fil-fajl.

It-tikketti ta' identifikazzjoni tal-link jista' jkun fihom ittri, numri, spazju abjad, u punteġġjatura, iżda leLeHuwa sensittiv għall-każijiet, għalhekk iż-żewġ links li ġejjin huma l-istess:

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

Tag tal-link impliċitukaratteristika tippermettilek tħalli barra milli tispeċifika tikketta tal-link. F'dan il-każ, it-tikketta tal-link se tiġi ttrattata bħala ekwivalenti għat-test tal-link. Biex tuża tag tal-link impliċita, żid parentesi kwadra vojta wara t-test tal-link. Jekk trid "Google " Linking ma' google.com, tista' tissimplifika għal:

[Google][]

Imbagħad iddefinixxi l-kontenut tal-link:

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

Peress li t-test tal-link jista' jkun fih spazju abjad, dan il-markup simplifikat jista' jkun fih diversi kliem:

Visit [Daring Fireball][] for more information.

Imbagħad kompli biex iddefinixxi l-link:

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

Id-definizzjoni tal-link tista' titqiegħed kullimkien fil-fajl. Nippreferi npoġġiha direttament wara l-paragrafu fejn tidher il-link. Tista 'wkoll tpoġġiha fl-aħħar tal-fajl, bħal kumment.

Hawn eżempju ta' link ta' referenza:

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"

Jekk tibdelha biex tuża l-isem tal-link biex tikteb:

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ż-żewġ modi ta 'kitba ta' hawn fuq se jipproduċu l-HTML li ġej.

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

Hawn taħt hemm fajl Markdown tal-istess kontenut miktub inline, ipprovdut għal tqabbil:

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").

Fil-fatt, il-punt ta' links ta' stil ta' referenza mhuwiex li huma aktar faċli biex tikteb, iżda li huma aktar faċli biex jinqraw. Qabbel l-eżempju ta 'hawn fuq. L-artikolu ta' stil ta 'referenza innifsu huwa biss 81 karattru, iżda l-forma inline se tiżdied għal 176 karattru. , jekk jinkiteb f'format HTML pur, ikun hemm karattru 234. Fil-format HTML, hemm aktar tikketti milli test.

Bl-użu tal-links tal-istil ta' referenza ta' Markdown, tista' tagħmel id-dokument aktar jixbah ir-riżultat finali tal-browser, li jippermettilek tmexxi xi metadejta relatata mal-markup barra mit-test tal-paragrafu, u tista' żżid links mingħajr ma tagħmel il-qari jħossu tal-artiklu. .

强调

Markdown juża asterisks (*) u l-linja tal-qiegħ (_) bħala simbolu biex timmarka kelma enfasizzata, hija * Jew _ Kliem imdawra jinqalbu għal <em> imdawwar b’tikketti, b’żewġ * Jew _Jekk ikun imgeżwer, se jiġi kkonvertit fi <strong>,Eż:

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

ser jinbidel fi:

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

Tista 'tuża kwalunkwe stil li tixtieq, l-unika limitazzjoni hija li tista' tuża s-simbolu biex tiftaħ it-tikketta u s-simbolu biex ittemmha.

L-enfasi tista’ tiddaħħal ukoll direttament fin-nofs tat-test:

un*frigging*believable

immajekk tiegħek * 和 _ Jekk hemm spazju abjad fuq iż-żewġ naħat, huma biss ittrattati bħala simboli normali.

Biex daħħal asterisks normali jew underscores direttament qabel u wara t-test, tista' tuża backslashes:

\*this text is surrounded by literal asterisks\*

Kodiċi

Jekk trid timmarka biċċa żgħira ta 'kodiċi inline, tista' tgeżwerha f'backticks (`), eż:

Use the `printf()` function.

Se tipproduċi:

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

Jekk trid iddaħħal backticks ġewwa sezzjoni tal-kodiċi, tista 'tibda u ttemm is-sezzjoni tal-kodiċi b'backticks multipli:

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

Din is-sintassi tipproduċi:

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

Tista' tpoġġi vojt fil-bidu u fit-tmiem ta' sezzjoni tal-kodiċi, waħda wara l-bidu u waħda qabel it-tmiem, sabiex tkun tista' ddaħħal backticks fil-bidu tat-taqsima:

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

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

Se tipproduċi:

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

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

Ġewwa t-taqsima tal-kodiċi,& u parentesi angolari都se jiġi konvertit awtomatikament f'entitajiet HTML, li jagħmilha faċli biex tiddaħħal il-kodiċi tas-sors HTML, Markdown se jpoġġi l-paragrafu li ġej:

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

lil:

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

Tista 'wkoll tikteb dan:

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

Biex tipproduċi:

<p><code>&#8212;</code> is the decimal-encoded
equivalent of <code>&mdash;</code>.</p>

图片

Ovvjament, huwa diffiċli li tiddisinja sintassi "naturali" biex tiddaħħal immaġini f'applikazzjoni ta 'test biss.

Markdown juża sintassi simili għal links biex jimmarka immaġini, u jippermetti wkoll żewġ stili: F'konformità和Referenza.

Is-sintassi tal-immaġni inline tidher bħal:

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

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

Id-dettalji huma kif ġej:

• marka ta’ esklamazzjoni !
• segwit minn parentesi kwadra b'test alternattiv għall-immaġni
• Dan huwa segwit minn parentesi normali mal-URL tal-immaġini, u finalment test fakultattiv tat-'titlu' magħluq bi kwotazzjonijiet.

Is-sintassi tal-immaġni ta' referenza tidher bħal din:

![Alt text][id]

"id" huwa l-isem tar-referenza tal-immaġni, li hija definita bl-istess mod bħal referenza tal-link:

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

S'issa, Markdown m'għandu l-ebda mod biex jispeċifika l-wisa 'u l-għoli tal-immaġni, jekk għandek bżonn, tista' tuża n-normali <img> tikketta.

其它

rabta awtomatika

Markdown jappoġġja l-ipproċessar ta' URLs u emails fil-forma ta' links awtomatiċi iqsar. Sakemm ikunu magħluqa f'parentesi angolari, Markdown awtomatikament jikkonvertih f'link.It-test tal-link tal-URL ġenerali huwa l-istess bħall-indirizz tal-link, pereżempju:

<http://example.com/>

Markdown se jiġi kkonvertit għal:

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

Ir-rabta awtomatika tal-indirizzi tal-email hija wkoll simili ħafna, ħlief li Markdown l-ewwel se jwettaq proċess ta 'konverżjoni ta' kodifikazzjoni, li jikkonverti karattri tat-test f'entitajiet HTML eżadeċimali. Dan il-format jista 'jqarraq xi robots ħżiena tal-ġbir tal-indirizzi tal-email, bħal:

<[email protected]>

Markdown ser jinbidel fi:

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

Fil-browser, din is-sekwenza (fil-fatt <a href="mailto:[email protected]">[email protected]</a>) issir link "indirizz@eżempju.com" li tista' tikklikkja.

(Għalkemm dan l-approċċ jista 'jqarraq ħafna robots, ma jistax iwaqqafhom kollha, iżda huwa aħjar minn xejn. Fi kwalunkwe każ, il-ftuħ tal-kaxxa postali tiegħek eventwalment jattira ittri ta' reklamar.)

backslash

Markdown jista’ juża backslashes biex idaħħal simboli li għandhom tifsiriet oħra fil-grammatika, pereżempju: jekk trid iżżid asterisk ħdejn it-test għall-enfasi (iżda mhux <em> tag), tista' tippreċedi l-asterisk b'backslash:

\*literal asterisks\*

Markdown jappoġġja s-simboli li ġejjin preċeduti minn backslash biex jgħin biex jiddaħħlu simboli komuni:

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

Markdown editur b'xejn

Pjattaforma tal-Windows

• MarkdownPad
• MarkPad

Pjattaforma Mac

• artab

editur onlajn

• MPEditor

plugin tal-browser

• Markdown hawn plugin

*** Jekk hemm editur Markdown b'xejn aħjar biex jirrakkomanda, jekk jogħġbok oqgħod attent għall-feedbackChen Weiliang, grazzi!