Usho ukuthini uMarkdown? Ungayisebenzisa kanjani i-Markdown syntax/markup yokufometha?

UkuphawulaKusho ukuthini?

Ungayisebenzisa kanjani i-Markdown syntax/markup yokufometha?

Ukubuka konke

I-Markdown iwulimi lwemakhaphu olungasindi olwakhiwe ngu-John Gruber.

Ivumela abantu ukuthi "babhale amadokhumenti ngefomethi yombhalo ongenalutho okulula ukuyifunda nokubhala, bese beyiguqulela kumadokhumenti e-XHTML (noma i-HTML) avumelekile".

Ulimi lumunce izici eziningi zemakhaphu yombhalo ongenalutho osevele utholakale ku-imeyili.

U-John Gruber wadala ulimi lwe-Markdown ngo-2004, ngokubambisana no-Aaron Swartz ingxenye enkulu ku-syntax.Inhloso yolimi ukusebenzisa "ifomethi yombhalo ongenalutho efundeka kalula, elula ukuyibhala, futhi ongayikhetha iguqulelwa ku-XHTML (noma i-HTML) evumelekile".

inhloso

Umgomo we-Markdown uwukufinyelela "kulula ukufunda nokubhala kalula".

ukufundeka, kwenze noma kunjaloI-Internet Marketing, ulwazi lomsebenzisi lubaluleke kakhulu.

Idokhumenti ebhalwe ku-Markdown kufanele ikwazi ukushicilelwa ngokuqondile ngombhalo ongenalutho, futhi akufanele ibonakale sengathi yakhiwe omaka abaningi noma iziqondiso zokufometha.

I-syntax ye-Markdown ithonywa amafomethi athile akhona asuka kumbhalo kuya ku-HTML, okuhlanganisa i-Setext, i-atx, i-Textile, i-ReStructuredText, i-Grutatext, ne-EtText, kodwa umthombo omkhulu wogqozi ifomethi ye-imeyili yombhalo ongenalutho.

Ngamafuphi, i-syntax ye-Markdown yonke yakhiwe izimpawu, ezikhethwe ngokucophelela futhi imisebenzi yazo icacile ngokubuka nje.Isibonelo: beka izinkanyezi ezizungeze umbhalo ukuze ubukeke njengokuthi *ukugcizelela*.

Uhlu olukuMarkdown lubukeka njengohlu. Izingcaphuno ezivimbayo ku-Markdown zibukeka sengathi ucaphuna ucezu lombhalo, njengoba uwubonile kuma-imeyili.

Ihambisana ne-HTML

Umgomo wohlelo lolimi lwe-Markdown wukuba ulimi lokubhala lwewebhu.

I-Markdown ayihloselwe ukufaka esikhundleni se-HTML, noma ngisho ukusondela kuyo, inezinhlobo ezimbalwa kakhulu ze-syntax futhi ihambisana nesethi encane kuphela yemakhaphu ye-HTML. I-Markdown ayizange iqanjwe ukuze kwenziwe imibhalo ye-HTML ibe lula ukuyibhala.

Ngokubona kwami, i-HTML isivele kulula ukuyibhala. Umqondo we-Markdown ukwenza imibhalo ifundeke kalula, ibhale, futhi ishintshwe ngokuthanda kwakho. I-HTML iyifomethi yokushicilela, i-Markdown iyi-Ukubhalaifomethi ebhaliwe.Kanjalo, i-syntax yokufometha ka-Markdown ihlanganisa kuphela lokho okungenziwa umbhalo ongenalutho.

Omaka abangafakwanga yi-Markdown bangabhalwa nge-HTML ngqo kudokhumentiUkukhuthazwa Kwewebhukopisha.Asikho isidingo sokumaka lokhu njenge-HTML noma i-Markdown; vele wengeze umaka ngokuqondile.

Kuphela izingxenye ezithile ze-HTML block okufanele zivinjelwe - njenge <div>,<table>,<pre>,<p> kanye namanye amathegi, kufanele ahlukaniswe kwezinye izindawo eziqukethwe ngemigqa engenalutho ngaphambi nangemuva, futhi omaka bawo wokuvula nawokuvala akufanele ahlanganiswe namathebhu noma izikhala. Ijeneretha ye-Markdown ihlakaniphe ngokwanele ukuba ingangezi omaka be-HTML abangadingekile <p> Ilebula.

Isibonelo simi kanje, ukwengeza ithebula le-HTML kufayela le-Markdown:

这是一个普通段落。

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

这是另一个普通段落。

Qaphela ukuthi i-syntax yokufometha ye-Markdown phakathi komaka bebhulokhi ye-HTML ngeke icutshungulwe.Isibonelo, uma usebenzisa isitayela se-Markdown ngaphakathi kwamabhulokhi e-HTML*强调*ngeke ibe nomphumela.

Amathegi esigaba se-HTML (emgqeni) afana ne <span>,<cite>,<del> Ingasetshenziswa ngokukhululekile ezigabeni ze-Markdown, izinhlu noma izihloko.Ngokwemikhuba yomuntu siqu, ungasebenzisa nomamaka be-HTML ukufometha ngaphandle kokusebenzisa ifomethi ye-Markdown.Isibonelo: Uma ukhetha i-HTML <a> Noma <img> amathegi, angasetshenziswa ngokuqondile ngaphandle kwesixhumanisi noma i-syntax yethegi yesithombe enikezwe uMarkdown.

Ngokungafani phakathi kwamathegi e-HTML block, i-syntax ye-Markdown ivumelekile phakathi kwamathegi esigaba se-HTML.

Ukuguqulwa okuzenzakalelayo kwezinhlamvu ezikhethekile

Emafayilini e-HTML, kunezinhlamvu ezimbili ezidinga ukuphathwa okukhethekile: < Kanye & , < izimpawu zisetshenziselwa amathegi okuqala,& Izimpawu zisetshenziselwa ukumaka izinhlangano ze-HTML, uma nje ufuna ukubonisa isibonelo salezi zinhlamvu, kufanele usebenzise ifomu lebhizinisi, njenge < Kanye &,

& Abalingiswa bahlukumeza kakhulu ababhali bemibhalo yewebhu, uma uzobhala "AT&T",kumele ubhale"AT&T".ngenkathi uku-URL & Izinhlamvu nazo ziyaguqulwa.Isibonelo ofuna ukuxhuma ku-:

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

Kufanele ubhale ukuguqulwa kwe-URL njenge:

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

izofakwa kuthegi yesixhumanisi href ezindaweni.Akudingekile ukusho, lokhu kulula ukuziba, futhi cishe inani elikhulu lamaphutha atholwe ukuqinisekiswa kwamazinga e-HTML.

I-Markdown ikuvumela ukuthi ubhale izinhlamvu ngokwemvelo, futhi inakekela lokho okudingeka ukuguqulwa.uma usebenzisa & Uhlamvu luyingxenye yebhizinisi lohlamvu lwe-HTML, lushiywa lunjalo, ngaphandle kwalokho luguqulelwa kuye &;.

Ngakho-ke uma ufuna ukufaka uphawu lwe-copyright kudokhumenti ©, ungabhala:

©

I-Markdown izoyishiya ingakathintwa.Futhi uma ubhala:

AT&T

I-Markdown izoyiguqulela ku-:

AT&T

Isimo esifanayo siyenzeka futhi < notation, njengoba iMarkdown ivumela ukuhambisana kwe-HTML, uma ubeka < Izimpawu zisetshenziswa njengama-delimiters kumathegi e-HTML, futhi i-Markdown ngeke yenze ukuguqulwa kuzo, kodwa uma ubhala:

4 < 5

I-Markdown izoyiguqulela ku-:

4 < 5

Kodwa-ke, kufanele kuqashelwe ukuthi ngaphakathi kobubanzi bekhodi, kungakhathaliseki ukuthi i-inline noma i-block, < Kanye & zombili izimpawukufaneleziguqulelwa ezinhlakeni ze-HTML, isici esikuvumela ukuthi ubhale kalula ikhodi ye-HTML ku-Markdown (ngokungafani ne-HTML, lapho ubeka khona zonke < Kanye & Zonke ziguqulwa zibe izinhlangano ze-HTML, ukuze kubhalwe ikhodi ye-HTML kufayela le-HTML. )

block element

Izigaba nokuhlukana kwemigqa

Isigaba se-Markdown siqukethe umugqa owodwa noma eminingi elandelanayo yombhalo, owandulelwa futhi ulandelwa ulayini ongenalutho ongaphezu kowodwa (incazelo yomugqa ongenalutho iwukuthi ubonakala ungenalutho esibonisini futhi uthathwa njengomugqa ongenalutho. Ngokwesibonelo, , uma umugqa uqukethe izikhala namathebhu kuphela, umugqa uzophinde uthathwe njengomugqa ongenalutho).Izigaba ezijwayelekile akufanele zihlehliswe ngezikhala noma amathebhu.

Inkulumo ethi "iqukethe umugqa owodwa noma eminingi elandelanayo yombhalo" empeleni isho ukuthi i-Markdown ivumela ukunqanyulwa kwemigqa ephoqelelwe (ukufakwa kwemigqa emisha) ngaphakathi kwezigaba, isici esihlukile kwamanye amafomethi wombhalo kuya ku-HTML (okuhlanganisa nohlobo Olunyakazayo "Guqula Umugqa Breaks" option), amanye amafomethi azoguqulela ukuhlukana komugqa ngamunye kube <br /> Ilebula.

Uma uimpelaUfuna ukuthembela ku-Markdown ukuze uyifake <br /> Ukuze uthole amalebula, cindezela izikhala ezimbili noma ngaphezulu endaweni yokufaka bese ucindezela u-Enter.

Ngempela, kuthatha umsebenzi omncane (izikhala ezengeziwe) ukukhiqiza <br /> , kodwa umane nje "umugqa omusha ngamunye uguqulelwa kuye <br />"Indlela ayifanele kuMarkdown, em eMarkdownaiAma-blockquotes esitayela sika-L kanye nohlu olunezigaba eziningi alusizo nje kuphela kodwa futhi lufundeka kalula uma uhlela ngokunqamuka kwemigqa.

Isihloko

I-Markdown isekela ama-syntaxes amabili ezihlokweni, ezifana ne-Setext ne-atx-like.

Ifomu elifana ne-Settext liyifomu elinomugqa ophansi, kusetshenziswa = (isihloko esiphezulu) kanye - (Izihloko ze-oda lesibili), isibonelo:

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

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

noma yiliphi inani = Kanye - kungaba ngempumelelo.

Ifomu elifana ne-Atx lifaka u-1 kuya ku-6 ekuqaleni komugqa # , okuhambisana nezihloko 1 kuya ku-6, isibonelo:

# 这是 H1

## 这是 H2

###### 这是 H6

Ungakhetha "ukuvala" izihloko ezinjenge-atx, lokhu okobuhle kuphela, uma uzizwa ukhululekile ngale ndlela, ungayengeza ekugcineni komugqa. #, ngenkathi umugqa uphela # Inombolo akudingekile ukuthi ifane nesiqalo (inani lephawundi ekuqaleni komugqa linquma ukuhleleka kwesihloko):

# 这是 H1 #

## 这是 H2 ##

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

Ama-blockquotes ama-Blockquotes

Izingcaphuno ze-Markdown blockquotes zisetshenziswa ezifanayo nalezo ezisetshenziswa ku-imeyili > kwezingcaphuno.Uma ujwayelene nezingcaphuno ezinhlamvu ze-imeyili, uyazi ukuthi ungakha kanjani i-block quote efayeleni le-Markdown, elizobukeka sengathi uziphula imigqa ngokwakho, bese wengeza. > :

> 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-Markdown ikuvumela ukuthi ube nobuvila futhi wengeze umugqa wokuqala wesigaba sonke > :

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

Izithenjwa zokuvimba zingafakwa (isb: izinkomba ngaphakathi kwereferensi) ngokwengeza inombolo ehlukile ye > :

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

Amanye ama-syntaxes we-Markdown nawo angasetshenziswa ngaphakathi kwamabhulokhi acashuniwe, okuhlanganisa izihloko, izinhlu, amabhlogo wekhodi, njll.:

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

Noma yimuphi umhleli wombhalo onesizotha angakha kalula izingcaphuno zesitayela se-imeyili.Isibonelo ku-BBEdit ungakhetha umbhalo bese ukhetha kumenyukhulisa ukuhlelwa kwengcaphuno,

Uhlu

I-Markdown isekela izinhlu ezi-odwe nezinga-odwe.

Uhlu olungahlelekile lusebenzisa izinkanyezi, izimpawu zokuhlanganisa, noma izimpawu zokususa njengomaka ohlwini:

*   Red
*   Green
*   Blue

Ilingana ne:

+   Red
+   Green
+   Blue

Futhi kulingana nokuthi:

-   Red
-   Green
-   Blue

Uhlu olu-odwe lisebenzisa izinombolo ezilandelwa isikhathi:

1.  Bird
2.  McHale
3.  Parish

Kubalulekile ukuqaphela ukuthi izinombolo ozisebenzisayo kuthegi yohlu ayithinti i-HTML ephumayo. Imakhaphu ye-HTML ewumphumela yalolu hlu olungenhla kungaba:

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

Uma uhlu lwakho lubhalwe kanje:

1.  Bird
1.  McHale
1.  Parish

noma ngisho:

3. Bird
1. McHale
8. Parish

Nobabili nizothola okukhiphayo okufanayo kwe-HTML.Iphuzu liwukuthi, ungenza izinombolo zohlu efayeleni likaMarkdown zifane nemiphumela yokuphuma, noma uma uvilapha, awudingi ukuba nendaba nokunemba kwezinombolo nhlobo.

Uma usebenzisa ukubhala okuvilaphayo, kunconywa ukuthi uqale ngo-1. entweni yokuqala, ngoba i-Markdown ingase isekele isici sokuqala sohlu olu-odwe esikhathini esizayo.

Ithegi yento yohlu ivamise ukubekwa kwesokunxele, kodwa ingahlehliswa, ifike ezikhaleni ezi-3, futhi ithegi yento kufanele ilandelwe okungenani isikhala esisodwa noma ithebhu.

Ukuze wenze uhlu lubukeke luhle, ungahlela okuqukethwe ngokuhlehlisa okugxilile:

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

Kodwa uma uvilapha, lokho kulungile futhi:

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

Uma izinto zohlu zihlukaniswa imigqa engenalutho, i-Markdown izosebenzisa okuqukethwe kwezinto lapho ikhipha i-HTML. <p> Amalebula asongwe, isibonelo:

*   Bird
*   Magic

izoguqulelwa ku:

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

Kodwa lokhu:

*   Bird

*   Magic

izoguqulelwa ku:

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

Izinto zohlu zingaqukatha izigaba eziningi, futhi izigaba ezingaphansi kwento ngayinye kufanele zihlehliswe ngezikhala ezingu-4 noma ithebhu engu-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.

Kubukeka kungcono kakhulu uma uhlehlisa umugqa ngamunye, kunjalo, futhi, uma ubuvila, uMarkdown naye uyakuvumela:

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

Uma ufuna ukufaka ireferensi ngaphakathi kwento yohlu, ke > Kudingeka i-indent:

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

Uma ufuna ukubeka ibhulokhi yekhodi, ibhulokhi idinga ukuhlehliswakabili, okuyizikhala ezingu-8 noma amathebhu angu-2:

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

        <代码写在这>

Kunjalo, uhlu lwezinto lungenziwa ngephutha, into efana nale:

1986. What a great season.

Ngamanye amazwi, livela ekuqaleni komugqainombolo-inkathi-ingenalutho, ukugwema lokhu, ungakwazi ukwengeza i-backslash ngaphambi kwesikhathi.

1986\. What a great season.

ikhodi block

Ukubhala okuhlobene nohlelo noma ikhodi yomthombo wolimi lwethegi ngokuvamile inamabhulokhi ekhodi asehleliwe kakade. Ngokuvamile, asifuni ukuthi la mabhulokhi ahlelwe ngendlela yamafayela ezigatshana avamile, kodwa awabonise njengoba enjalo. I-Markdown izosebenzisa <pre> Kanye <code> amathegi okugoqa amabhlogo ekhodi.

Amabhulokhi wokwakha wekhodi ku-Markdown alula njengokuhlehlisa izikhala ezi-4 noma ithebhu engu-1, isibonelo, faka okulandelayo:

这是一个普通段落：

    这是一个代码区块。

I-Markdown izoguqulela ku:

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

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

Lokhu kuhlehlisa kwe-oda lokuqala ngomugqa ngamunye (izikhala ezi-4 noma ithebhu engu-1) kuyasuswa, isibonelo:

Here is an example of AppleScript:

    tell application "Foo"
        beep
    end tell

izoguqulelwa ku:

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

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

Ibhulokhi yekhodi iqhubeka kuze kube umugqa ongahlosiwe (noma ekupheleni kwefayela).

Ngaphakathi kwekhodi block, & , < Kanye > Izoguqulwa ngokuzenzakalelayo ibe izinhlangano ze-HTML. Le ndlela ikwenza kube lula kakhulu kuwe ukuthi usebenzise i-Markdown ukuze ufake ikhodi yomthombo we-HTML njengesibonelo, vele uyikopishe bese uyinamathisela, engeza ukuhlehlisa, bese enye i-Markdown izokuphathela yona, isibonelo:

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

izoguqulelwa ku:

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

Kubhulokhi yekhodi, i-syntax evamile ye-Markdown ngeke iguqulwe, njengezinkanyezi ziyizinkanyezi nje, okusho ukuthi ungakwazi ukubhala kalula amafayela ahlobene ne-Markdown syntax ku-Markdown syntax.

umhlukanisi

Ungasebenzisa ama-asterisk angaphezu kwamathathu, susa izimpawu, ama-underscore ukuze udale isihlukanisi emgqeni, akukho okunye emgqeni.Ungakwazi futhi ukufaka izikhala phakathi kwezinkanyezi noma izimpawu zokususa.Imigqa yokuhlukanisa ingadalwa ngendlela ngayinye kulezi ezilandelayo zokubhala:

* * *

***

*****

- - -

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

ingxenye yesigaba

isixhumanisi

I-Markdown isekela izinhlobo ezimbili ze-syntax yesixhumanisi: EmugqeniKanyeireferensiamafomu amabili.

Kunoma ikuphi, umbhalo wesixhumanisi umakwe ngokuthi [abakaki abayisikwele].

ukwakha aEmugqeniUma ufuna ukwengeza umbhalo wesihloko wesixhumanisi, vele usonge umbhalo wesihloko ngamamaki wokucaphuna akabili ngemva kwe-URL, isibonelo:

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

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

Izokhiqiza:

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

Uma uxhumanisa izinsiza kumsingathi ofanayo, ungasebenzisa izindlela ezihlobene:

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

ireferensiIsixhumanisi silandelwa omunye ubakaki oyisikwele ngemva kobakaki bombhalo wesixhumanisi, futhi umaki osetshenziselwa ukukhomba isixhumanisi kufanele ugcwaliswe kubakaki besikwele sesibili:

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

Ungakwazi futhi ukufaka isikhala phakathi kwabakaki ababili abayizikwele:

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

Bese, noma yikuphi kufayela, ungachaza okuqukethwe kwesixhumanisi salo thegi:

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

Okuqukethwe kwesixhumanisi kuchazwe ngendlela:

• Abakaki abayisikwele (ngokuzikhethela bandulelwe izikhala ezifika kwezintathu zokuhlehlisa) lapho kungena khona umbhalo wesixhumanisi
• kulandele ikholoni
• kulandelwe yisikhala esisodwa noma ngaphezulu noma ithebhu
• i-URL yesixhumanisi esilandelayo
• Landela ngokuzikhethela okuqukethwe kwesihloko, okungafakwa kumakhwothi owodwa, izingcaphuno ezikabili, noma abakaki

Izincazelo zalezi zixhumanisi ezintathu ezilandelayo ziyefana:

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

isexwayiso:Kunenkinga eyaziwayo lapho i-Markdown.pl 1.0.1 iziba khona izihloko zesixhumanisi ezifakwe kumakhwothi owodwa.

Ama-URL esixhumanisi nawo angafakwa kubakaki be-engeli:

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

Ungaphinda ubeke isibaluli sesihloko emugqeni olandelayo, noma wengeze ukuhlehlisa, okuzobukeka kangcono uma i-URL iyinde kakhulu:

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

Incazelo ye-URL isetshenziswa kuphela lapho kwakhiwa isixhumanisi, futhi ayiveli ngokuqondile efayelini.

Omaka bokuhlonza isixhumanisi bangaqukatha izinhlamvu, izinombolo, indawo emhlophe, nezimpawu zokuloba, kodwa akunjaloChaIyazwela, ngakho izixhumanisi ezimbili ezilandelayo ziyefana:

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

Umaka wesixhumanisi ongacacileisici sikuvumela ukuthi uyeke ukucacisa umaka wesixhumanisi. Kulesi simo, umaka wesixhumanisi uzothathwa njengolingana nombhalo wesixhumanisi. Ukuze usebenzise umaka wesixhumanisi ongacacile, vele wengeze ubakaki oyisikwele ongenalutho ngemva kombhalo wesixhumanisi. Uma ufuna "Google " Ngokuxhuma ku-google.com, ungenza kube lula ku-:

[Google][]

Bese uchaza okuqukethwe kwesixhumanisi:

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

Njengoba umbhalo wesixhumanisi ungase uqukathe isikhala esimhlophe, le makhaphu eyenziwe lula ingase ibe namagama amaningi:

Visit [Daring Fireball][] for more information.

Bese uqhubeka ukuchaza isixhumanisi:

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

Incazelo yesixhumanisi ingafakwa noma yikuphi efayeleni. Ngincamela ukuyibeka ngqo ngemva kwendima lapho isixhumanisi sivela khona. Ungakwazi futhi ukuyibeka ekugcineni kwefayela, njengokuphawula nje.

Nasi isibonelo sesixhumanisi sereferensi:

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"

Uma ulishintsha ukuze usebenzise igama lesixhumanisi ukuze ubhale:

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"

Izindlela ezimbili ezingenhla zokubhala zizokhiqiza i-HTML elandelayo.

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

Ngezansi ifayela le-Markdown lokuqukethwe okufanayo okubhalwe emgqeni, okuhlinzekelwe ukuqhathanisa:

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

Eqinisweni, iphuzu lezixhumanisi zesitayela sereferensi akukhona ukuthi kulula ukukubhala, kodwa ukuthi kulula ukuyifunda. Qhathanisa isibonelo esingenhla. Isihloko sesitayela sereferensi sona sinezinhlamvu ezingu-81 kuphela, kodwa ifomu elingaphakathi komugqa lizokhuphuka Izinhlamvu ezingu-176. , uma ibhalwe ngefomethi ye-HTML emsulwa, kuzoba nezinhlamvu ezingu-234. Ngefomethi ye-HTML, kunamathegi amaningi kunombhalo.

Ukusebenzisa izixhumanisi zesitayela sereferensi sika-Markdown kungenza idokhumenti ifane nomphumela wokugcina wesiphequluli, okukuvumela ukuthi uhambise imethadatha ethile ehlobene nemakhaphu ngaphandle kombhalo wepharagrafu, futhi ungakwazi ukwengeza izixhumanisi ngaphandle kokwenza i-athikili ifundwe. phazamisa.

gcizelela

I-Markdown isebenzisa izinkanyezi (*) kanye nesisekelo (_) njengophawu lokumaka igama elidwetshelwe, is * Noma _ Amagama azungezwe aguqulwa abe <em> ezungezwe amalebula, anamabili * Noma _Uma igoqwe, izoguqulwa ibe <strong>,Isb:

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

izophenduka ibe:

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

Ungasebenzisa noma yisiphi isitayela osithandayo, okuwumkhawulo kuphela ukuthi ungasebenzisa uphawu ukuvula ithegi kanye nophawu ukuyiqeda.

Ukugcizelela kungafakwa ngqo phakathi kombhalo:

un*frigging*believable

kodwauma eyakho * Kanye _ Uma kunezikhala ezimhlophe nhlangothi zombili, ziphathwa njengezimpawu ezijwayelekile,

Ukuze ufake izinkanyezi ezivamile noma ama-underscore ngokuqondile ngaphambi nangemuva kombhalo, ungasebenzisa ama-backslash:

\*this text is surrounded by literal asterisks\*

Ikhodi

Uma ufuna ukumaka ucezu oluncane lwekhodi esemgqeni, ungalugoqa ngama-backticks (`),Isb:

Use the `printf()` function.

Izokhiqiza:

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

Uma ufuna ukufaka ama-backticks ngaphakathi kwesigaba sekhodi, ungaqala futhi uqedele isigaba sekhodi ngama-backticks amaningi:

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

Le syntax ikhiqiza:

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

Ungabeka okungenalutho ekuqaleni nasekupheleni kwesigaba sekhodi, eyodwa ngemva kwesiqalo neyodwa ngaphambi kokuphela, ukuze ukwazi ukufaka ama-backticks ekuqaleni kwesigaba:

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

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

Izokhiqiza:

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

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

Ngaphakathi kwesigaba sekhodi,& kanye nabakaki be-engeliKonkeizoguqulwa ngokuzenzakalela ibe yizinhlangano ze-HTML, okwenza kube lula ukufaka ikhodi yomthombo we-HTML, i-Markdown izobeka isigaba esilandelayo:

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

kuya:

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

Ungabhala futhi lokhu:

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

Ukukhiqiza:

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

图片

Ngokusobala, kunzima ukuklama i-syntax "yemvelo" yokufaka izithombe kuhlelo lokusebenza lombhalo kuphela.

I-Markdown isebenzisa i-syntax efana naleyo yezixhumanisi ukumaka izithombe, futhi ivumela izitayela ezimbili: EmugqeniKanyeireferensi,

I-syntax yesithombe esisemgqeni ibonakala kanje:

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

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

Imininingwane imi kanje:

• isibabazo !
• kulandelwe ubakaki oyisikwele onombhalo ohlukile wesithombe
• Lokhu kulandelwa abakaki abavamile abane-URL yesithombe, futhi ekugcineni kube nombhalo 'wesihloko' ongazikhethela ofakwe kumakhwothi.

I-syntax yesithombe esiyisethenjwa ibukeka kanje:

![Alt text][id]

"i-id" igama lereferensi yesithombe, elichazwa ngendlela efanayo nereferensi yesixhumanisi:

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

Kuze kube manje, i-Markdown ayinayo indlela yokucacisa ububanzi nokuphakama kwesithombe, uma udinga, ungasebenzisa okujwayelekile <img> Ilebula.

其它

isixhumanisi esizenzakalelayo

I-Markdown isekela ukucubungula ama-URL namabhokisi e-imeyili ngendlela yezixhumanisi ezizenzakalelayo ezimfishane uma kuqhathaniswa. Inqobo nje uma evalelwe kubakaki be-engeli, i-Markdown izoyiguqulela ngokuzenzakalelayo ibe isixhumanisi.Umbhalo wesixhumanisi we-URL evamile uyafana nekheli lesixhumanisi, isibonelo:

<http://example.com/>

I-Markdown izoguqulelwa ku-:

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

Ukuxhumanisa okuzenzakalelayo kwamakheli e-imeyili nakho kuyefana, ngaphandle kokuthi i-Markdown izoqala yenze inqubo yokuguqula umbhalo wekhodi, iguqule izinhlamvu zombhalo zibe izinto ze-HTML ze-hexadecimal. Le fomethi ingakhohlisa amarobhothi eqoqo lamakheli e-imeyili amabi, afana nala:

<[email protected]>

I-Markdown izophenduka ibe:

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

Kusiphequluli, lolu chungechunge (empeleni <a href="mailto:[email protected]">[email protected]</a>) iba isixhumanisi esithi "[email protected]" esichofozekayo.

(Nakuba le ndlela ingakhohlisa amarobhothi amaningi, ayikwazi ukuwamisa wonke, kodwa ingcono kunalutho. Kunoma ikuphi, ukuvula ibhokisi lakho lemeyili ekugcineni kuzoheha izinhlamvu zokukhangisa.)

ukuhlehla

I-Markdown ingasebenzisa ama-backslash ukuze ifake izimpawu ezinezinye izincazelo ohlelweni lolimi, isibonelo: uma ufuna ukwengeza inkanyezi eduze kombhalo ukuze ugcizelele (kodwa hhayi <em> tag), ungandulela inkanyezi nge-backslash:

\*literal asterisks\*

I-Markdown isekela izimpawu ezilandelayo ezandulelwa i-backslash ukusiza ukufaka izimpawu ezivamile:

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

Umhleli wamahhala we-Markdown

Inkundla yeWindows

• I-MarkdownPad
• I-MarkPad

Inkundla yeMac

• ezithambile

umhleli we-inthanethi

• I-MPEditor

i-plugin yesiphequluli

• I-plugin ye-Markdown lapha

*** Uma kukhona isihleli samahhala se-Markdown esingasincoma, sicela unake impendulo kusoU-Chen Weiliang,ngiyabonga!