Ithetha ukuthini iMarkdown? Uyisebenzisa njani i-markdown syntax/markup ifomathi?

MarkdownIngaba ithetha ukuthini?

Uyisebenzisa njani i-syntax ye-Markdown / uphawulo lokufomatha?

Ushwankathelo

UMarkdown lulwimi olukhaphukhaphu lophawulo olwenziwe nguJohn Gruber.

Ivumela abantu ukuba "babhale amaxwebhu ngefomathi yokubhaliweyo ecacileyo ekulula ukuyifunda nokubhala, kwaye emva koko baguqulele kumaxwebhu asebenzayo eXHTML (okanye HTML)".

Ulwimi luthathe uninzi lweempawu zophawulo lokubhaliweyo olungenanto esele lufunyenwe kwi-imeyile.

UJohn Gruber udale ulwimi lweMarkdown kwi-2004, ngokubambisana no-Aaron Swartz inxalenye enkulu kwi-syntax.Injongo yolwimi kukusebenzisa "ifomati yombhalo ocacileyo ekulula ukuyifunda, kulula ukuyibhala, kwaye iguqulelwe ngokuzithandela kwi-XHTML esebenzayo (okanye i-HTML)".

injongo

Injongo yeMarkdown kukuba "kulula ukufunda kwaye kube lula ukubhala".

ukufundeka, yenza njaloIntengiso ye-Intanethi, amava omsebenzisi abaluleke kakhulu.

Uxwebhu olubhalwe kwi-Markdown kufuneka lukwazi ukupapashwa ngokuthe ngqo kumbhalo ongenanto, kwaye akufanele kubonakale ngathi luqulunqwe ngeethegi ezininzi okanye izikhokelo zokufomatha.

I-syntax ye-Markdown iphenjelelwa zezinye iifomati ze-text-to-HTML ezikhoyo ezikhoyo, kuquka i-Setext, i-atx, i-Textile, i-ReStructuredText, i-Grutatext, kunye ne-EtText, kodwa owona mthombo omkhulu wempembelelo yifomati ye-imeyile yombhalo ocacileyo.

Ngamafutshane, i-syntax yeMarkdown yonke yenziwe ngeesimboli, ezikhethwe ngononophelo kwaye imisebenzi yazo icacile ngokujonga nje.Umzekelo: beka iinkwenkwezi ngeenxa zonke kwisicatshulwa ukwenza kubonakale ngathi *ugxininiso*.

Uluhlu olukwiMarkdown lujongeka ngathi, kakuhle, uluhlu. Iingcaphuno zebhlokhi kuMarkdown zikhangeleka ngathi zicaphula isiqwenga sombhalo, njengoko ubonile kwii-imeyile.

Iyahambelana neHTML

Injongo yegrama yeMarkdown kukuba ibe lulwimi lokubhala kwiwebhu.

I-Markdown ayenzelwanga ukuthatha indawo ye-HTML, okanye ide isondele kuyo, ineentlobo ezimbalwa kakhulu ze-syntax kwaye ihambelana kuphela neseti encinci yophawulo lwe-HTML. I-Markdown ayizange ikhawulwe ukwenza amaxwebhu e-HTML abhalwe lula.

Ngokombono wam, i-HTML sele ilula ukuyibhala. Umbono weMarkdown kukwenza amaxwebhu afundeke lula, abhale, kwaye atshintshe ngokuthanda. I-HTML yifomathi yokupapasha, iMarkdown yiukukhuphelaifomathi ebhaliweyo.Ngaloo ndlela, i-syntax yokufomatha kaMarkdown igubungela kuphela oko kubhaliweyo okucacileyo.

Iithegi ezingagqunywanga yiMarkdown zinokubhalwa ngeHTML ngqo kuxwebhuuKhuthazo lweWebhuikopi.Akukho mfuneko yokumakisha oku njenge HTML okanye iMarkdown; yongeza nje uphawu ngokuthe ngqo.

Kuphela ezinye izinto zebhloko ze-HTML eziza kunyanzelwa - ezinje <div>,<table>,<pre>,<p> kunye nezinye iithegi, kufuneka zihlulwe kwezinye iindawo zomxholo kunye nemigca engenanto ngaphambi nasemva, kwaye iithegi zabo zokuvula kunye nokuvala akufanele zifakwe kwiithebhu okanye izithuba. I-Markdown generator ihlakaniphile ngokwaneleyo ukuba ingafaki iithegi zebhloko ze-HTML ezingafunekiyo <p> Ileyibhile.

Umzekelo umi ngolu hlobo lulandelayo, ukongeza itafile yeHTML kwifayile yeMarkdown:

这是一个普通段落。

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

这是另一个普通段落。

Qaphela ukuba i-syntax yokufomatha i-Markdown phakathi kweethegi zebhloko ye-HTML ayizukwenziwa.Umzekelo, ukuba usebenzisa isitayile seMarkdown ngaphakathi kwebhloko ye-HTML*强调*ayiyi kuba nasiphumo.

HTML icandelo (inline) iithegi ezifana <span>,<cite>,<del> Inokusetyenziswa ngokukhululekileyo kwimihlathi yeMarkdown, izintlu okanye izihloko.Ngokwemikhwa yobuqu, unokusebenzisa iithegi zeHTML ukufomatha ngaphandle kokusebenzisa ifomathi yeMarkdown.Umzekelo: Ukuba ukhetha i-HTML <a> Okanye <img> iithegi, ezinokusetyenziswa ngokuthe ngqo ngaphandle kwekhonkco okanye isivakalisi sethegi yomfanekiso enikezwe nguMarkdown.

Ngokungafaniyo phakathi kweethegi zebhloko ze-HTML, i-syntax ye-Markdown iyasebenza phakathi kweethegi zecandelo le-HTML.

Uguqulelo oluzenzekelayo lwabalinganiswa abakhethekileyo

Kwiifayile ze-HTML, kukho iimpawu ezimbini ezifuna ukuphathwa okukhethekileyo: < Kunye kunye & , < iisimboli zisetyenziselwa ukuqala iithegi,& Iimpawu zisetyenziselwa ukuphawula amaziko e-HTML, ukuba ufuna nje ukubonisa umzobo wabalinganiswa, kufuneka usebenzise uxwebhu lwequmrhu, njenge. < Kunye kunye &,

& Abalinganiswa bathuthumbisa ngakumbi kubabhali bamaxwebhu ewebhu, ukuba uya kuchwetheza "AT&T", kufuneka ubhale "AT&T".ngelixa ukwi-URL & Abalinganiswa bayaguqulwa.Umzekelo ufuna ukudibanisa ku:

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

Kuya kufuneka ubhale uguqulelo lwe-URL njengo:

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

ibekwe kwithegi yekhonkco href kwiipropati.Akufuneki ukuthetha, oku kulula ukungayihoyi, kwaye mhlawumbi elona nani likhulu leempazamo ezichongiweyo ngokuqinisekiswa kwemigangatho ye-HTML.

I-Markdown ikuvumela ukuba ubhale abalinganiswa ngokwemvelo, kwaye iyakukhathalela oko kufuneka kuguqulwe.ukuba uyayisebenzisa & Umlinganiswa yinxalenye yequmrhu lomlinganiswa weHTML, lishiywe linjalo, kungenjalo liguqulwa libe &;.

Ke ukuba ufuna ukufaka isimboli yelungelo lokushicilela kuxwebhu ©, ungabhala:

©

I-Markdown iya kuyishiya ingabanjwanga.Kwaye ukuba uyabhala:

AT&T

I-Markdown iya kuyiguqulela ku:

AT&T

Imeko efanayo iyenzeka kwakhona < ubhalo, kuba iMarkdown ivumela ukuhambelana kweHTML, ukuba uyabeka < Iimpawu zisetyenziswa njenge-delimiters kwiithegi ze-HTML, kwaye i-Markdown ayizukwenza naluphi na uguqulelo kuzo, kodwa ukuba ubhala:

4 < 5

I-Markdown iya kuyiguqulela ku:

4 < 5

Nangona kunjalo, kufuneka kuqatshelwe ukuba ngaphakathi kwendawo yekhowudi, nokuba ingaphakathi okanye ibhloko, < Kunye kunye & yomibini imiqondisokufunekaziguqulelwa kumaziko e-HTML, uphawu olukuvumela ukuba ubhale ngokulula ikhowudi yeHTML kwiMarkdown (ngokuchaseneyo neHTML, apho ubeka khona zonke < Kunye kunye & Zonke ziguqulwa zibe ngamaziko e-HTML, ukuze kubhalwe ikhowudi ye-HTML kwifayile ye-HTML. )

block element

Imihlathi kunye noqhawulo lwemigca

Umhlathi weMarkdown uqulathe imigca enye okanye ngaphezulu elandelelanayo yokubhaliweyo, eyandulelweyo kwaye ilandelwa ngaphaya komgca omnye ongenanto (inkcazelo yomgca ongenanto kukuba ibonakala ingenanto ekuboniseni kwaye ithathwa njengomgca ongenanto. Umzekelo. , ukuba umgca uqulethe izithuba kunye neethebhu kuphela, umgca uya kuthathwa njengomgca ongenanto).Imihlathi eqhelekileyo ayifanelanga idityaniswe nezithuba okanye iithebhu.

Ibinzana elithi "liqulathe imigca enye okanye ngaphezulu elandelelanayo yombhalo" eneneni ithetha ukuba iMarkdown ivumela imigca emitsha enyanzelwayo (ukufakwa kwemigca emitsha) phakathi kwemihlathi, uphawu olwahlukileyo kwezinye iifomathi ezininzi zokubhaliweyo ukuya kwi-HTML (kubandakanya udidi olushenxisekayo "Guqula uLwahlulo lomgca. " ukhetho), ezinye iifomati ziyakuguqula uqhawulo lomgca ngalunye lube <br /> Ileyibhile.

Ukuba ukanjaloUfuna ukuthembela kwiMarkdown ukuze uyifake <br /> Ukufumana iilebhile, cofa izithuba ezibini nangaphezulu kwindawo yofakelo uze ucofe u-Enter.

Ngokwenene, kuthatha umsebenzi omncinci (izithuba ezongezelelweyo) ukuvelisa <br /> , kodwa ngokulula "umgca omtsha ngamnye uguqulelwa kuye <br />"Indlela ayifanelekanga eMarkdown, em eMarkdownaiUcaphulo lwebhloko yesimbo se-L kunye noluhlu lwemihlathi emininzi aluloncedo kuphela kodwa lukwalula ukufundeka xa ucwangcisa ngohlobo lokuqhawulwa kwemigca.

Isihloko

I-Markdown ixhasa i-syntaxes ezimbini zezihloko, i-Setext-like kunye ne-atx-like.

I-Settext-like form yifom enomgca osezantsi, usebenzisa = (esona sihloko siphezulu) kunye - (Izihloko zolandelelwano lwesibini), umzekelo:

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

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

nayiphi na imali = Kunye kunye - inokusebenza.

Ifom efana ne-Atx ifaka i-1 ukuya kwi-6 ekuqaleni komgca # , ehambelana nezihloko 1 ukuya ku-6, umzekelo:

# 这是 H1

## 这是 H2

###### 这是 H6

Ungakhetha "ukuvala" iiheader ezinjenge-atx, oku kuphela kwe-aesthetics, ukuba uziva ukhululekile ngale ndlela, ungayongeza ekupheleni komgca. #, ngelixa umgca uphela # Inani akunyanzelekanga ukuba lifane nesiqalo (inani loonobumba beponti ekuqaleni komgca limisela ulandelelwano lwesihloko):

# 这是 H1 #

## 这是 H2 ##

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

Iingcaphuno zeBlockquotes

I-Markdown markup blockquotes isetyenziswa ngokufanayo naleyo isetyenziswe kwi-imeyile > yezicatshulwa.Ukuba uqhelene neengcaphuno kwiileta ze-imeyile, uyayazi indlela yokwenza isicatshulwa sebhloko kwifayile yeMarkdown, enokubonakala ngathi uyaphula imigca ngokwakho, wongeze. > :

> 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 ukuba ube nevila kwaye wongeze kuphela umgca wokuqala womhlathi wonke > :

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

Iimbekiselo zebhlokhi zinokubekwa (umzekelo: iimbekiselo ngaphakathi kweembekiselo) ngokongeza inani elahlukileyo le > :

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

Ezinye ii-syntaxes ze-Markdown nazo zinokusetyenziswa ngaphakathi kweebhloko ezicatshulweyo, kuquka izihloko, uluhlu, iibhloko zekhowudi, njl.

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

Nawuphi na umhleli wombhalo onesidima unokudala ngokulula izicatshulwa zesimbo se-imeyile.Umzekelo kwi-BBEdit ungakhetha okubhaliweyo uze ukhethe kwimenyuukwandisa ulawulo lokucaphula,

Uluhlu

I-Markdown ixhasa uluhlu olucwangcisiweyo kunye noluhlu olungacwangciswanga.

Uluhlu olungacwangciswanga lusebenzisa iinkwenkwezi, kunye nemiqondiso, okanye iimpawu zothabatha njengeziphawuli zoluhlu:

*   Red
*   Green
*   Blue

Ilingana ne:

+   Red
+   Green
+   Blue

Kwakhona ilingana ne:

-   Red
-   Green
-   Blue

Uluhlu olucwangcisiweyo lusebenzisa amanani alandelwa lixesha:

1.  Bird
2.  McHale
3.  Parish

Kubalulekile ukuqaphela ukuba amanani owasebenzisayo kuluhlu lwethegi awachaphazeli imveliso yeHTML.Isiphumo sophawulo lweHTML yoluhlu olungentla luyakuba:

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

Ukuba uluhlu lwakho lubhalwe ngolu hlobo:

1.  Bird
1.  McHale
1.  Parish

okanye nkqu:

3. Bird
1. McHale
8. Parish

Nobabini niya kufumana imveliso yeHTML efanayo.Ingongoma kukuba, unokwenza amanani oluhlu kwifayile yeMarkdown afane neziphumo zemveliso, okanye ukuba uyonqena, awudingi ukukhathalela ukuchaneka kwamanani konke konke.

Ukuba usebenzisa ukubhala okuvilayo, kucetyiswa ukuba uqale nge-1. kwinto yokuqala, kuba iMarkdown inokuxhasa uphawu lokuqala lwezintlu ezicwangcisiweyo kwixesha elizayo.

Ithegi yento yoluhlu iqhele ukubekwa ekhohlo kude, kodwa inokuthi ifakwe i-indent, ukuya kuthi ga kwizithuba ezi-3, kwaye ithegi yomba kufuneka ilandelwe sisithuba esinye okanye ithebhu.

Ukwenza uluhlu lubukeke luhle, unokucwangcisa imixholo nge-indent engatshintshiyo:

*   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 ukuba uyonqena, kulungile:

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

Ukuba uluhlu lwezinto zahlulwe ngemigca engenanto, iMarkdown iya kusebenzisa umxholo wezinto xa ikhupha iHTML. <p> Iileyibhile isongiwe, umzekelo:

*   Bird
*   Magic

iza kuguqulelwa ku:

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

Kodwa oku:

*   Bird

*   Magic

iza kuguqulelwa ku:

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

Izinto zoluhlu zinokuqulatha imihlathi emininzi, kwaye imihlathi ephantsi kwento nganye kufuneka idityaniswe ngezithuba ezi-4 okanye ithebhu ye-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.

Ijongeka ingcono kakhulu ukuba uhlehlisa umgca ngamnye, ewe, kwakhona, ukuba uyonqena, iMarkdown ikwavumela:

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

Ukuba ufuna ukubeka ireferensi ngaphakathi kwento yoluhlu, ke > Kufuneka ifakwe i-indent:

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

Ukuba ufuna ukubeka ibhloko yekhowudi, ibhloko kufuneka ifakwe ngaphakathiKabini, enezithuba ezi-8 okanye iithebhu ezi-2:

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

        <代码写在这>

Ewe kunjalo, uluhlu lwezinto lunokwenziwa ngengozi, into efana nale:

1986. What a great season.

Ngamanye amazwi, ibonakala ekuqaleni komgcainombolo-ixesha-ingenanto, ukunqanda oku, unokongeza i-backslash ngaphambi kwexesha.

1986\. What a great season.

ikhowudi block

Ubhalo olunxulumene nenkqubo okanye ikhowudi yomthombo wethegi yolwimi idla ngokuba neebhloko zekhowudi yokuchwetheza. Ngokwesiqhelo, asifuni ukuba ezibhloko zicwangciswe ngendlela yeefayile zemihlathi ngokubanzi, kodwa zibonise njengoko zinjalo. UMarkdown uya kusebenzisa <pre> Kunye kunye <code> iithegi zokusonga iibhloko zekhowudi.

Iibhloko zokwakha zekhowudi kwi-Markdown zilula njengokuhlehlisa izithuba ezi-4 okanye ithebhu enye, umzekelo, faka oku kulandelayo:

这是一个普通段落：

    这是一个代码区块。

I-Markdown iya kuguqula ibe:

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

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

Olu lungelelwaniso lolandelelwano lokuqala ngomgca ngamnye (izithuba ezi-4 okanye ithebhu e-1) luyasuswa, umzekelo:

Here is an example of AppleScript:

    tell application "Foo"
        beep
    end tell

iza kuguqulelwa ku:

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

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

Ibhloko yekhowudi iyaqhubeka de kube umgca ongafakwanga (okanye ekupheleni kwefayile).

Ngaphakathi kwibhloko yekhowudi, & , < Kunye kunye > Izakuguqulwa ngokuzenzekelayo ibe ngamaziko eHTML Le ndlela yenza kubelula kakhulu kuwe ukuba usebenzise iMarkdown ukufaka ikhowudi yemvelaphi yeHTML yomzekelo, khuphela nje kwaye uyincamathisele, yongeza i-indentation, kwaye enye iMarkdown iya kukwenzela yona, kuba umzekelo:

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

iza kuguqulelwa ku:

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

Kwibhloko yekhowudi, i-syntax ye-Markdown jikelele ayiyi kuguqulwa, njengeenkwenkwezi nje ziinkwenkwezi, oku kuthetha ukuba unokubhala ngokulula iifayile ezinxulumene ne-syntax ye-Markdown kwi-syntax ye-Markdown.

umahluli

Ungasebenzisa ngaphezu kweenkwenkwezi ezintathu, thabatha imiqondiso, i-underscores ukwenza isahluli emgceni, akukho nto iyenye emgceni.Unako kwakhona ukufaka izithuba phakathi kweenkwenkwezi okanye thabatha iimpawu.Imigca yokwahlula inokwenziwa ngendlela nganye kwezi zilandelayo zokubhala:

* * *

***

*****

- - -

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

isiqalelo secandelo

ikhonkco

I-Markdown ixhasa iindlela ezimbini ze-syntax yekhonkco: NomgcaKunye kunyeIsalathisoiifom ezimbini.

Nokuba yeyiphi na indlela, isicatshulwa sekhonkco siphawulwe nge [izibiyeli zesikwere].

ukwenza iNomgcaUkuba ufuna ukongeza isicatshulwa sesihloko sekhonkco, vele usonge isicatshulwa sesihloko ngamanqaku aphindwe kabini emva kwe-URL, umzekelo:

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

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

Izakuvelisa:

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

Ukuba unxibelelanisa nezibonelelo kumamkeli omnye, ungasebenzisa iindlela ezihambelanayo:

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

IsalathisoIkhonkco lilandelwa sesinye isibiyeli esisikweri emva kwe-parenthesis yombhalo wekhonkco, kwaye uphawu olusetyenziselwa ukuchonga ikhonkco kufuneka luzaliswe kwisibiyeli sesibini sesikwere:

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

Unokukhetha kwakhona ukubeka isithuba phakathi kwezibiyeli ezimbini zesikwere:

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

Emva koko, naphi na kwifayile, ungachaza umxholo wekhonkco wale tag:

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

Umxholo wonxulumaniso uchazwe ngendlela:

• Izibiyeli ezisikwere (ukhetho lwandulelwe ukuya kuthi ga kwizithuba ezithathu zolungelelwaniso) ekungeniswa kuzo ikhonkco lokubhaliweyo
• kulandele ikholoni
• ilandelwa sisithuba esinye okanye ngaphezulu okanye ithebhu
• iURL yekhonkco elilandelayo
• Landela ngokhetho umxholo wesihloko, onokuthi ufakwe kwizicatshulwa zodwa, ukucaphula kabini, okanye izibiyeli

Iinkcazo zala makhonkco mathathu alandelayo ziyafana:

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

isilumkiso:Kukho umcimbi owaziwayo apho i-Markdown.pl 1.0.1 ingayihoyi izihloko zekhonkco ezifakwe kwiicatshulwa enye.

Ii-URL zekhonkco zinokuvalelwa kwizibiyeli ze-engile:

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

Ungaphinda ubeke uphawu loyelelwano kumgca olandelayo, okanye wongeze i-indentation, eya kujongeka ngcono ukuba i-URL inde kakhulu:

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

Inkcazo ye-URL isetyenziswa kuphela xa kusenziwa ikhonkco, kwaye ayiveli ngqo kwifayile.

Iithegi zokuchongwa kwekhonkco zinokuqulatha oonobumba, amanani, indawo emhlophe, kunye neziphumlisi, kodwa akunjaloHayiYimeko ebuthathaka, ngoko ke amakhonkco amabini alandelayo ayafana:

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

Ithegi yekhonkco engabonakaliyoInqaku likuvumela ukuba ushiye ukucacisa itegi yekhonkco. Kulo mzekelo, ithegi yekhonkco iya kuphathwa njengelingana nombhalo wekhonkco. Ukusebenzisa ithegi yekhonkco efihlakeleyo, yongeza nje isibiyeli esingenanto emva kombhalo wekhonkco. Ukuba ufuna "uGoogle weGoogle "Ukudibanisa ne-google.com, unokwenza lula uku:

[Google][]

Emva koko uchaze umxholo wekhonkco:

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

Kuba umbhalo wekhonkco unokuqulatha isithuba esimhlophe, oluphawu lwenziwe lula lusenokuba namagama amaninzi:

Visit [Daring Fireball][] for more information.

Emva koko qhubeka uchaze ikhonkco:

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

Inkcazo yekhonkco inokubekwa naphi na kwifayile.Ndikhetha ukuyibeka ngokuthe ngqo emva komhlathi apho ikhonkco livela khona.Ungaphinda uyibeke ekupheleni kwefayile, nje ngoluvo.

Nanku umzekelo wekhonkco lereferensi:

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"

Ukuba uyayitshintsha ukuze usebenzise igama lekhonkco ukubhala:

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"

Ezi ndlela zimbini zokubhala zingentla ziya kuvelisa le HTML ilandelayo.

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

Apha ngezantsi kukho ifayile yeMarkdown yomxholo ofanayo obhalwe emgceni, obonelelwe ukuthelekisa:

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

Enyanisweni, inqaku le-reference-style links ayikokuba kulula ukuyibhala, kodwa kulula ukuyifunda Thelekisa lo mzekelo ungasentla Inqaku le-reference-style ngokwayo linamagama angama-81 kuphela, kodwa ifom engaphakathi iya kunyuka ukuya Oonobumba be-176.

Usebenzisa amakhonkco endlela yereferensi kaMarkdown, unokwenza uxwebhu lube njengesiphumo sokugqibela sesikhangeli, ikuvumela ukuba uhambise imetadata enxulumene nophawu ngaphandle kombhalo womhlathi, kwaye unokongeza amakhonkco ngaphandle kokwenza ukufunda kuvakale kwenqaku. .

gxininisa

I-Markdown isebenzisa iinkwenkwezi (*) kunye nomgca osezantsi (_) njengophawu lokuphawula igama elikrwelelwe umgca ngaphantsi, ngu * Okanye _ Amagama ajikelezileyo aguqulwa abe <em> singqongwe ngeeleyibhile, ezinezimbini * Okanye _Ukuba isongiwe, iya kuguqulwa ibe <strong>,Umzekelo:

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

iya kujika ibe:

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

Ungasebenzisa nasiphi na isimbo osithandayo, umda kuphela kukuba ungasebenzisa isimboli ukuvula ithegi kunye nesimboli ukuyiphelisa.

Ugxininiso lunokufakwa ngqo embindini wesicatshulwa:

un*frigging*believable

kodwaukuba eyakho * Kunye kunye _ Ukuba kukho indawo emhlophe kumacala omabini, aphathwa nje njengeempawu eziqhelekileyo,

Ukufakela iinkwenkwezi eziqhelekileyo okanye ii underscores ngokuthe ngqo phambi nasemva kokubhaliweyo, ungasebenzisa umqolo:

\*this text is surrounded by literal asterisks\*

Ikhowudi

Ukuba ufuna ukuphawula iqhekeza elincinci lekhowudi engaphakathi, ungayisonga ngomqolo (`),Umzekelo:

Use the `printf()` function.

Izakuvelisa:

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

Ukuba ufuna ukufaka ii-backticks ngaphakathi kwecandelo lekhowudi, ungaqala kwaye uphelise icandelo lekhowudi ngee-backticks ezininzi:

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

Le syntax ivelisa:

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

Ungabeka indawo engenanto ekuqaleni nasekupheleni kwecandelo lekhowudi, enye emva kwesiqalo kwaye enye ngaphambi kokuphela, ukuze ufake ii-backticks ekuqaleni kwecandelo:

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

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

Izakuvelisa:

<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 kwecandelo lekhowudi,& kunye nezibiyeli ze-engile都iyakuguqulwa ngokuzenzekelayo kumaziko e-HTML, eyenza kube lula ukufaka ikhowudi yemvelaphi ye-HTML, iMarkdown izakubeka lo mhlathi ulandelayo:

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

ukuya:

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

Ungabhala kwakhona oku:

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

Ukuvelisa:

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

图片

Ngokucacileyo, kunzima ukuyila i-syntax "yendalo" yokufaka imifanekiso kwisicelo sombhalo kuphela.

I-Markdown isebenzisa i-syntax efana naleyo yekhonkco ukuphawula imifanekiso, kwaye ivumela izitayile ezimbini: NomgcaKunye kunyeIsalathiso,

I-syntax yemifanekiso engaphakathi ibonakala ngolu hlobo:

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

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

Iinkcukacha zezi zilandelayo:

• uphawu lwesikhuzo !
• ilandelwa sisibiyeli esinesikwere esinombhalo wealt womfanekiso
• Oku kulandelwa zizibiyeli eziqhelekileyo ezine-URL yomfanekiso, kwaye okokugqibela kukhetho 'isihloko' okubhaliweyo okufakwe kwizicatshulwa.

I-syntax yomfanekiso wereferensi ibonakala ngolu hlobo:

![Alt text][id]

"id" ligama lereferensi yomfanekiso, echazwa ngendlela efanayo nereferensi yekhonkco:

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

Ukuza kuthi ga ngoku, iMarkdown ayinayo indlela yokuchaza ububanzi kunye nobude bomfanekiso, ukuba ufuna, ungasebenzisa okuqhelekileyo <img> Ileyibhile.

其它

ikhonkco elizenzekelayo

I-Markdown ixhasa ukusetyenzwa kwe-URLs kunye neebhokisi ze-imeyile ngokohlobo lwamakhonkco amafutshane azenzekelayo.Njengoko zivalelwe kwizibiyeli ze-engile, iMarkdown iya kuyiguqulela ngokuzenzekelayo ibe likhonkco.Umbhalo wekhonkco we-URL ngokubanzi uyafana nedilesi yekhonkco, umzekelo:

<http://example.com/>

I-Markdown iya kuguqulwa ibe:

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

Ukudityaniswa okuzenzekelayo kweedilesi ze-imeyile kukwafana kakhulu, ngaphandle kokuba iMarkdown izakwenza kuqala inkqubo yoguqulelo lwekhowudi, iguqulela amagama abhaliweyo kumaziko e-HTML anehexadecimal.

<[email protected]>

I-Markdown iya kujika ibe:

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

Kwibrawuza, lo mtya (eneneni <a href="mailto:[email protected]">[email protected]</a>) iba likhonkco elithi "[email protected]".

(Nangona le ndlela inokuqhatha iirobhothi ezininzi, ayinakukwazi ukuzinqanda zonke, kodwa ingcono kunanto. Ngayiphi na imeko, ukuvula ibhokisi yeposi ekugqibeleni kuya kutsala iileta zentengiso.)

umva

I-Markdown inokusebenzisa ii-backslashs ukufaka iisimboli ezinezinye iintsingiselo kwigrama, umzekelo: ukuba ufuna ukongeza iinkwenkwezi ecaleni kwesicatshulwa ukuze ugxininise (kodwa hayi <em> ithegi), ungayandulela iinkwenkwezi nge-backslash:

\*literal asterisks\*

I-Markdown ixhasa ezisimboli zilandelayo ezandulelwa yi-backslash ukunceda ukufaka iisimboli eziqhelekileyo:

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

Umhleli wasimahla weMarkdown

Iqonga leWindows

• I-MarkdownPad
• I-MarkPad

iqonga Mac

• soft

umhleli we-intanethi

• Umhleli weMPE

isikhangeli plugin

• Phawula apha iplagin

*** Ukuba kukho umhleli weMarkdown ongcono wasimahla onokucebisa, nceda ubeke ingqalelo kwingxeloChen Weiliang,enkosi!