Waa maxay macnaha Markdown? Sida loo isticmaalo Markdown syntax/hab calaamadaynta?

MarkdownMaxaa loola jeedaa?

Sida loo isticmaalo Markdown syntax/samaynta habaynta?

Guudmarka

Markdown waa luqad calaamade fudud oo uu sameeyay John Gruber.

Waxay u ogolaataa dadka inay "ku qoraan dukumentiyada qaab qoraal ah oo sahlan oo sahlan in la akhriyo oo la qoro, ka dibna u beddelo dukumeenti XHTML (ama HTML) oo sax ah".

Luuqadu waxa ay ku daraysaa qaar badan oo ka mid ah sifada calaamadaynta qoraalka cad ee horeba loogu helay iimaylka.

John Gruber wuxuu abuuray luqadda Markdown 2004, isagoo kaashanaya Aaron Swartz oo qayb weyn ka ah syntax.Ujeeddada luqadda waa in la isticmaalo "qaab qoraal ah oo fudud oo ay fududahay in la akhriyo, si sahlan loo qoro, oo ikhtiyaar ahaan u beddelaya XHTML (ama HTML) sax ah".

ujeedo

Hadafka Markdown waa "inay fududahay in la akhriyo oo si sahlan loo qoro".

akhriska, samee si kastabaSuuqgeynta Internetka, waayo-aragnimada isticmaaluhu waa mid aad muhiim u ah.

Dukumeentiga ku qoran Markdown waa inuu awood u yeeshaa in si toos ah loogu daabaco qoraal cad, oo aanu u muuqan inuu ka kooban yahay calaamado badan ama dardaaran qaabaynta.

Syntax Markdown waxaa saameeya qaar ka mid ah qoraalada jira ee qaababka HTML, oo ​​ay ku jiraan Setext, atx, Textile, restructuredText, Grutatext, iyo EtText, laakiin isha ugu weyn ee dhiirigelinta waa qaabka emailka qoraalka ah.

Marka la soo koobo, ereyga Markdown wuxuu ka kooban yahay calaamado, kuwaas oo si taxadar leh loo xushay shaqadooduna ay cad yihiin marka la eego.Tusaale ahaan: dhig calaamado ku wareegsan qoraalka si aad ugu ekaato *xoojinta*.

Liisaska ku yaal Markdown waxay u egyihiin, si fiican, liisas. Xigashooyinka 'Blockquotes' ee Markdown runtii waxay u egyihiin xigashada qayb qoraal ah, sida aad ku aragtay iimaylada.

La jaan qaadaya HTML

Hadafka naxwaha Markdown waa inuu ahaado luqad wax lagu qoro shabakada.

Markdown looguma talagalin in lagu badalo HTML, ama xitaa u soo dhawaado, waxa ay leedahay kala duwanaansho eray bixineed aad u yar oo kaliya waxa ay u dhigantaa qayb yar oo HTML ah. Markdown looma fikirin si waraaqaha HTML looga dhigo mid fudud in la qoro.

Fikradayda, HTML mar horeba way fududahay in la qoro. Fikradda Markdown waa in dukumentiyada loo fududeeyo akhrinta, qorista, iyo beddelka marka la doono. HTML waa qaab daabacaad, Markdown waa aQoraalka qoraalkaqaab qoraal ah.Sidan oo kale, habaynta Markdown's syntax kaliya waxay daboolaysaa waxa qoraalka cadi awoodo.

Calaamadaha aan la daboolin Markdown waxay ku qori karaan HTML si toos ah dukumeentigaHorumarinta Shabkadanuqul.Looma baahna in tan lagu calaamadiyo HTML ama Markdown; kaliya ku dar calaamadaynta si toos ah.

Kaliya qaar ka mid ah curiyeyaasha HTML xannibaya waa in la xaddidaa - sida <div>,<table>,<pre>,<p> iyo calaamado kale, waa in laga soocaa meelaha kale ee leh khadadka maran ka hor iyo ka dibba, furahooda iyo xidhitaankooda lama geli karo tabs ama meelo bannaan. Dhaliyaha Markdown waa caqli ku filan inuusan ku darin calaamadaha xannibaadda HTML ee aan loo baahnayn <p> Summada

Tusaalaha waa sida soo socota, ku darista miiska HTML ee faylka Markdown:

这是一个普通段落。

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

这是另一个普通段落。

Ogsoonow in habaynta Markdown syntax u dhexeeya HTML block tags aan la habayn doonin.Tusaale ahaan, haddii aad isticmaasho qaabka Markdown gudaha block HTML ah*强调*saameyn kuma yeelan doonto.

Qaybta HTML (inline) tags sida <span>,<cite>,<del> Waxaa si xor ah loogu isticmaali karaa cutubyada Markdown, liisaska ama cinwaannada.Marka loo eego caadooyinka shakhsi ahaaneed, waxaad xitaa isticmaali kartaa HTML tags si aad u qaabeyso adigoon isticmaalin qaabka Markdown.Tusaale: Haddii aad doorbidayso HTML <a> Ama <img> tags, kaas oo si toos ah loo isticmaali karo iyada oo aan la helin isku xirka ama sawirka tag syntax ee uu bixiyo Markdown.

Si ka duwan inta u dhaxaysa tags block HTML, Markdown syntax waa ansax inta u dhaxaysa tags qaybta HTML.

U beddelashada tooska ah ee jilayaasha gaarka ah

Faylasha HTML, waxaa jira laba xaraf oo u baahan maarayn gaar ah: < Oo & . < calaamadaha waxaa loo isticmaalaa bilowga tags,& Calaamadaha waxaa loo isticmaalaa in lagu calaamadiyo HTML, haddii aad rabto inaad muujiso tusaalaha jilayaashan, waa inaad isticmaashaa foomka cidda, sida < Oo &.

& Calaamaduhu waxay si gaar ah u dhibayaan qorayaasha dukumeentiga shabakada, haddii aad rabto inaad wax qorto "AT&T", waa inaad qortaa"AT&T"inta ku jirta URL & Jilayaasha sidoo kale waa la beddelaa.Tusaale ahaan waxaad doonaysaa inaad ku xidhidhdo:

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

Waa inaad u qortaa beddelka URL sida:

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

in lagu dhejiyo link tag href guryaha ku jira.Looma baahna in la sheego, tani way fududahay in la iska indho tiro, oo laga yaabo inay tahay tirada ugu badan ee khaladaadka lagu ogaado ansaxinta heerarka HTML.

Markdown wuxuu kuu ogolaanayaa inaad si dabiici ah u qorto jilayaasha, waxayna daryeeshaa waxa loo baahan yahay in la beddelo.haddii aad isticmaasho & Dabeecaddu waa qayb ka mid ah jilayaasha HTML, waa loo daayaa sidiisa, haddii kale waa loo rogaa &;

Markaa haddii aad rabto inaad geliso calaamadda xuquuqda daabacaada dukumeentiga ©, waxaad qori kartaa:

©

Markdown waxay ka tagi doontaa iyada oo aan la taaban.Haddii aad qorto:

AT&T

Markdown waxay u rogi doontaa:

AT&T

Xaalad la mid ah ayaa sidoo kale ka dhacda < calaamad, mar haddii Markdown ogolaado waafaqsan HTML, haddii aad dhigto < Calaamadaha waxaa loo isticmaalaa sidii xadeeyayaasha HTML tags, Markdown-na wax beddel ah kuma sameyn doono iyaga, laakiin haddii aad qorto:

4 < 5

Markdown waxay u rogi doontaa:

4 < 5

Si kastaba ha ahaatee, waa in la ogaadaa in baaxadda koodka, haddii ay tahay khadka ama block. < Oo & labada calaamadoodHubaalWaxaa loo beddelaa qaybaha HTML, muuqaal kuu oggolaanaya inaad si fudud ugu qorto HTML code Markdown (oo ka duwan HTML, halkaas oo aad geliso dhammaan < Oo & Dhammaantood waxaa loo beddelaa qaybaha HTML, si loogu qoro HTML koodka faylka HTML. )

curiyaha xannibaadda

Baaragaraafyada iyo xariiqyada xariiqda

Baaragaraafka Markdown wuxuu ka kooban yahay hal ama in ka badan oo isku xigta oo qoraal ah, ka hor oo ay raacaan in ka badan hal xariiq oo maran (qeexidda xariiqda bannaan waa in ay u muuqato in ay madhan tahay bandhigga waxaana loo arkaa in ay tahay khad maran. Tusaale ahaan, , haddii xariiqa ka kooban yahay meelo bannaan iyo tabs, xariiqda waxaa sidoo kale loo daaweeyaa sidii xariiq maran).Baaragaraafyada caadiga ah waa in aan lagu dhex gelin meelo bannaan ama tabs.

Weedha "waxay ka kooban tahay hal ama in ka badan oo isku xigta oo qoraal ah" waxay dhab ahaantii tilmaamaysaa in Markdown ay ogolaato khadadka cusub ee qasabka ah (gelinta khadadka cusub) ee cutubyada gudahooda, muuqaal ka duwan inta badan qoraallada kale ee qaababka HTML (oo ay ku jiraan Nooca Dhaqdhaqaaqa "Beddelida Khadadka Cusub) "ikhtiyaarka", qaabab kale ayaa u rogi doona xariiq kasta oo jaban <br /> Summada

Hadaaddhab ahaantiiWaxaad rabtaa inaad ku tiirsanaato Markdown si aad u geliso <br /> Calaamadaha, taabo laba ama in ka badan oo bannaan meesha la geliyo ka dibna taabo Gelida.

Runtii, waxay qaadataa shaqo yar oo dheeri ah si loo dhaliyo <br /> , laakiin si fudud "line kasta oo cusub ayaa loo rogaa <br />"Qaabka kuma haboona Markdown, em in MarkdownaiXigashooyinka qaabka L-style iyo liisaska tuducyada badan ma aha oo kaliya faa'iido badan laakiin sidoo kale way fududahay in la akhriyo marka wax lagu qorayo jajabyada laynka.

Cinwaanka

Markdown waxay taageertaa laba eray oo cinwaano ah, Setext-like iyo atx-like.

Foomka Settext u eg waa foomka leh xariiqda hoose, iyadoo la adeegsanayo = (ciwaanka ugu sarreeya) iyo - (ciwaanada nidaamka labaad), tusaale ahaan:

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

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

qadar kasta = Oo - waxay noqon kartaa wax ku ool ah.

Foomka Atx u eg wuxuu gelinayaa 1 ilaa 6 bilowga xariiqda # , oo u dhiganta ciwaannada 1 ilaa 6, tusaale ahaan:

# 这是 H1

## 这是 H2

###### 这是 H6

Waxaad si ikhtiyaari ah u "xiri kartaa" cinwaanno u eg, tani waxay kaliya u tahay bilicda, haddii aad ku qanacsan tahay habkan, waxaad ku dari kartaa dhamaadka khadka. #, inta xariiqdu dhammaanayso # Lambarku maaha inuu la mid noqdo bilowga (tirada jilayaasha rodol ee bilowga xariiqda ayaa go'aamisa sida ay u kala horreeyaan):

# 这是 H1 #

## 这是 H2 ##

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

Blockquotes Blockquotes

Xigashooyinka calaamadaynta calaamadaynta waxaa loo isticmaalaa si la mid ah kuwa lagu isticmaalo iimaylka > ee xigashooyinka.Haddii aad taqaano xigashooyinka xarfaha iimaylka, waxaad taqaanaa sida loo sameeyo oraah block ah ee faylka Markdown, kaas oo u ekaan lahaa inaad adigu jebiso khadadka, ka dibna ku dar > :

> 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 wuxuu kaloo kuu ogolaanayaa inaad caajis noqoto oo aad ku darto kaliya xariiqda koowaad ee cutubka oo dhan > :

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

Tixraacyada xannibaadda waxaa lagu dhejin karaa (tusaale: tixraacyada tixraacyada) iyadoo lagu darayo tiro ka duwan > :

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

Qoraallada kale ee Markdown sidoo kale waxaa loo isticmaali karaa baloogyada la soo xigtay, oo ay ku jiraan cinwaannada, liisaska, xirmooyinka koodka, iwm.

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

Tafatire kasta oo wanaagsan wuxuu si fudud u abuuri karaa xigasho u eg iimaylka.Tusaale ahaan BBEdit waxaad dooran kartaa qoraal ka dibna ka dooro liiskakordhinta kala sareynta xigashada.

Liiska

Markdown waxay taageertaa liisaska la dalbaday iyo kuwa aan la dalban.

Liisaska aan la dalban waxay u adeegsadaan calaamado, calaamado lagu daray, ama calaamado laga jaray sida liiska:

*   Red
*   Green
*   Blue

U dhiganta:

+   Red
+   Green
+   Blue

Sidoo kale u dhiganta:

-   Red
-   Green
-   Blue

Liisaska la dalbaday waxay adeegsadaan nambaro ay ku xigto xilli:

1.  Bird
2.  McHale
3.  Parish

Waxaa muhiim ah in la ogaado in lambarada aad ku isticmaashid liiska summada aysan saameyn ku yeelan HTML soo saarista.

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

Haddii liiska calaamadayntaadu u qoran tahay sida:

1.  Bird
1.  McHale
1.  Parish

ama xataa:

3. Bird
1. McHale
8. Parish

Labadiinaba waxaad heli doontaan wax soo saar HTML isku mid ah.Ujeedadu waxay tahay, waxaad samayn kartaa liiska lambarada ku jira faylka Markdown si la mid ah natiijooyinka wax soo saarka, ama haddii aad caajis tahay, uma baahnid inaad daryeesho saxnaanta tirooyinka gabi ahaanba.

Haddii aad isticmaasho qoraal caajis ah, waxaa lagu talinayaa inaad ku bilowdo 1. shayga ugu horreeya, sababtoo ah Markdown waxaa laga yaabaa inay taageerto sifada bilawga liisaska la dalbaday mustaqbalka.

Liiska shayga summada waxaa badanaa lagu dhejiyaa bidixda fog, laakiin waa la jeexjeexi karaa, ilaa 3 boos, shayga summadana waa in la raacaa ugu yaraan hal boos ama tab.

Si aad liiska uga dhigto mid wanaagsan, waxaad ku habayn kartaa waxa ku jira fargeeto go'an:

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

Laakiin haddii aad caajis tahay, taasi sidoo kale waa fiican tahay:

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

Haddii shayada liiska lagu kala saaro khadad madhan, Markdown wuxuu isticmaali doonaa waxa ku jira marka uu soo saarayo HTML. <p> Calaamadaha waa la duubay, tusaale ahaan:

*   Bird
*   Magic

waxaa loo rogi doonaa:

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

Laakiin tani:

*   Bird

*   Magic

waxaa loo rogi doonaa:

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

Shayada liisku waxay ka koobnaan karaan cutubyo badan, cutubyada hoos yimaada shay kastana waa inay jeexjeexaan 4 boos ama 1 tab:

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.

Waxay u egtahay mid aad u fiican haddii aad jeexdid xariiq kasta, dabcan, mar labaad, haddii aad caajis tahay, Markdown sidoo kale wuxuu ogolaanayaa:

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

Haddii aad rabto in aad geliso tixraac gudaha shayga liiska, markaa > Waxay u baahan tahay in la geliyo:

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

Haddii aad rabto inaad dhejiso block kood, balooggu wuxuu u baahan yahay in la geliyolaba jeer, kaas oo ah 8 boos ama 2 tabs:

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

        <代码写在这>

Dabcan, liiska alaabta ayaa si lama filaan ah loo soo saari karaa, wax sidan oo kale ah:

1986. What a great season.

Si kale haddii loo dhigo, waxay u muuqataa bilowga xariiqdatiro-muddo-madhan, si taas looga fogaado, waxaad ku dari kartaa dib u dhac ka hor caadada.

1986\. What a great season.

block code

Qoritaanka barnaamijka la xidhiidha qoraalka ama summada isha luqadda ayaa sida caadiga ah horeyba u lahaan jiray blocks code-ka, sida caadiga ah, ma rabno in baloogyadan loo habeeyo habka faylalka cutubka guud, laakiin u muuji sida ay yihiin.Markdown ayaa isticmaali doona. <pre> Oo <code> tags si loo duubo blocks code.

Abuuritaanka blocks code ee Markdown waa mid fudud sida galinta 4 boos ama 1 tab. Tusaale ahaan, geli kuwa soo socda:

这是一个普通段落：

    这是一个代码区块。

Markdown waxa uu u rogi doonaa:

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

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

Soo gelitaan-dalabka koowaad ee xariiq kasta (4 boos ama 1 tab) waa la saarayaa, tusaale ahaan:

Here is an example of AppleScript:

    tell application "Foo"
        beep
    end tell

waxaa loo rogi doonaa:

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

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

Qeybta koodka ayaa sii socota ilaa xariiqda aan la daboolin (ama dhamaadka faylka).

Gudaha block kood, & , < Oo > Waxa si toos ah loogu badali doonaa HTML-ka, Habkani waxa uu kuu sahlayaa inaad isticmaasho Markdown si aad u geliso koodhka HTML tusaale ahaan, koobi ka bixi oo paste, ku dar indentation, inta soo hadhayna Markdown ayaa adiga kuu qaban doonta, tusaale:

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

waxaa loo rogi doonaa:

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

Qeybta koodka, ereyga guud ee Markdown looma beddeli doono, sida asterisks waa xiddigo kaliya, taas oo macnaheedu yahay inaad si fudud ugu qori karto faylasha la xidhiidha Markdown syntax ee Markdown syntax.

qaybiye

Waxaad samayn kartaa qaybiye leh in ka badan saddex xiddigood, calaamado laga jaray, hoosta ka xarriiqay khadka, wax kale kuma jiraan khadka.Waxa kale oo aad geli kartaa boosaska u dhexeeya xiddigaha ama calaamadaha laga jaray.Xadadka kala soocida waxaa lagu abuuri karaa mid kasta oo ka mid ah hababka soo socda ee qoraalka:

* * *

***

*****

- - -

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

qaybta qaybta

isku xidhka

Markdown waxay taageertaa laba nooc oo isku xidhka isku xidhka ah: InlineOoTixraaclaba nooc.

Si kastaba ha noqotee, qoraalka isku xirka waxaa lagu calaamadeeyay [ brackets square].

in la abuuro aInlineHaddii aad rabto inaad ku darto qoraalka ciwaanka ee isku xidhka, kaliya ku duub qoraalka ciwaanka calamadaha xigashada laba jibaaran ka dib URL, tusaale ahaan:

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

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

soo saari doona:

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

Haddii aad ku xidhidhayso ilaha isla martigaliyaha, waxaad isticmaali kartaa wadooyin qaraabo ah:

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

TixraacXidhiidhku waxa raacaya garab labajibbaaran kale ka dib qawska qoraalka xidhiidhka, iyo calaamada loo isticmaalo in lagu aqoonsado xidhiidhka waa in lagu buuxiyaa garab labajibbaaran ee labaad:

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

Waxa kale oo aad si ikhtiyaari ah u dhigi kartaa meel bannaan oo u dhaxaysa labada geesood ee labajibbaaran:

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

Markaa, meel kasta oo faylka ah, waxaad qeexi kartaa waxa ku jira summadan:

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

Mawduuca isku xidhka waxa lagu qeexay qaabka:

• Xirmooyinka labajibbaaran (ikhtiyaar ahaan ay ka horreeyaan ilaa saddex meelood oo meel la geli karo) kuwaas oo qoraalka isku xidhka la geliyo
• oo ay ku xigto colon
• oo ay ku xigto hal ama in ka badan oo bannaan ama tabs
• URL ee isku xirka xiga
• Ikhtiyaar ahaan raac nuxurka ciwaanka, kaas oo lagu soo lifaaqi karo hal xigasho, xigasho labanlaab ah, ama jaantusyo

Qeexitaannada saddexda xiriiriye ee soo socda waa isku mid:

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

Fadlan ogow:Waxaa jirta arrin la yaqaan oo Markdown.pl 1.0.1 iska indhatirto cinwaannada isku xirka ee ku lifaaqan hal xigasho.

URL-yada isku xidhka waxa kale oo lagu xidhi karaa geesaha xagasha:

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

Waxa kale oo aad ku dhejin kartaa sifada ciwaanka ee xariiqda xigta, ama waxaad ku dari kartaa qayb ka mid ah, taas oo si fiican u ekaan doonta haddii URL-ku aad u dheer yahay:

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

Qeexida URL-ka waxa kaliya oo la adeegsadaa marka la soo saarayo isku xirka, oo si toos ah ugama soo muuqan faylka.

Calaamadaha aqoonsiga linkiga waxa ku jiri kara xarfo, nambaro, meel cad, iyo xarakayn, laakiin mayaMayaWaa arrin xasaasi ah, markaa labada xiriiriye ee soo socda waa isku mid:

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

sumadda isku xidhka aan toosnaynsifada waxay kuu ogolaanaysaa inaad iska dhaafto qeexida calaamada isku xidhka "Ku xidhida google.com, waxaad u fududayn kartaa:

[Google][]

Kadibna qeex waxa ku jira xidhiidhka:

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

Mar haddii qoraalka xidhiidhku ka koobnaan karo meel cad, calaamadayntan la fududeeyay waxa ku jiri kara kelmado badan:

Visit [Daring Fireball][] for more information.

Kadib sii wad si aad u qeexdo isku xirka:

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

Qeexida linkiga waxaa la dhigi karaa meel kasta oo faylka ah, waxaan doorbidayaa in aan si toos ah u dhigo ka dib cutubka meesha uu ka soo baxo linkiga, waxaad sidoo kale ku dhejin kartaa dhammaadka faylka, sida faallooyinka.

Waa kan tusaale xiriiriye tixraac:

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"

Haddii aad u bedesho si aad u isticmaasho magaca isku xidhka si aad u qorto:

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"

Labada hab ee sare ee qoraalku waxay soo saari doonaan HTML-ka soo socda.

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

Hoos waxaa ku yaal fayl Markdown ah oo isla nuxur ah oo khadka ku qoran, oo loo bixiyey isbarbardhigga:

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

Dhab ahaantii, barta tixraaca-style links ma aha in ay fududahay in la qoro, laakiin waa sahlan tahay in la akhriyo, barbar dhig tusaalaha kore. 81 xaraf, haddii lagu qoro qaab HTML saafi ah, waxaa jiri doona 176 xaraf, qaabka HTML, waxaa jira calaamado ka badan qoraalka.

Adigoo isticmaalaya isku xirka qaabka tixraaca ee Markdown, waxaad ka dhigi kartaa dukumeentiga mid lamid ah natiijada ugu dambeysa ee browserka, taasoo kuu ogolaaneysa inaad u guurto qaar ka mid ah xog-ururinta la xiriirta meel ka baxsan qoraalka cutubka, waxaadna ku dari kartaa xiriirinta adigoon samaynin dareenka akhrinta maqaalka. .

Adkee

Markdown waxay isticmaashaa xidigta (Asterisks)*) iyo gunta hoose (_) sida calaamad lagu calaamadiyo kelmad hoosta laga xarriiqay, waa * Ama _ Erayada ku xeeran ayaa loo rogaa <em> oo ay ku wareegsan yihiin calaamado, oo leh laba * Ama _Haddii la duubo, waxaa loo rogi doonaa <strong>, Tusaale ahaan:

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

waxay isu rogi doontaa:

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

Waxaad isticmaali kartaa qaab kasta oo aad jeceshahay, xaddidaadda kaliya ayaa ah inaad ku furto sumadda calaamadda aad rabto inaad ku dhameysato.

Culayska waxa kale oo si toos ah loo dhex gelin karaa qoraalka:

un*frigging*believable

laakiinhaddii adiga * Oo _ Haddii ay jiraan meel cad oo labada dhinac ah, waxaa loola dhaqmaa sida calaamado caadi ah.

Si aad u geliso calaamadaha caadiga ah ama hoosta ka xariiqay si toos ah ka hor iyo ka dib qoraalka, waxaad isticmaali kartaa dib-u-dhac:

\*this text is surrounded by literal asterisks\*

Xeer

Haddii aad rabto inaad calaamadiso qayb yar oo kood ah, waxaad ku duubi kartaa dhabarka dambe (`), tusaale:

Use the `printf()` function.

soo saari doona:

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

Haddii aad rabto inaad geliso dhabarka dambe ee qaybta koodka, waxaad ku bilaabi kartaa oo ku dhamayn kartaa qaybta koodka adigoo wata dhawr jeer:

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

Ereygan ayaa soo saaray:

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

Waxa aad dhigi kartaa maran bilowga iyo dhamaadka qaybta koodka, mid ka dambeeya bilowga iyo mid ka horeeya dhamaadka, si aad u geliso dhabarka bilowga qaybta:

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

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

soo saari doona:

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

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

Gudaha qaybta code,& iyo xagalka xagasha都si toos ah ayaa loogu beddeli doonaa qaybaha HTML, taas oo sahlaysa in la geliyo koodhka isha HTML, Markdown ayaa gelin doona cutubkan soo socda:

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

ku:

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

Waxaad sidoo kale qori kartaa tan:

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

Si loo soo saaro:

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

Sawir

Sida cad, way adagtahay in la naqshadeeyo ereyga "dabiiciga ah" ee gelinta sawirada codsiga qoraalka-kaliya.

Markdown waxay isticmaashaa syntax la mid ah xiriirinta si ay u calaamadiso sawirada, sidoo kale waxay ogolaataa laba qaab: InlineOoTixraac.

Sawirka khad dhexdeedka ah wuxuu u eg yahay:

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

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

Faahfaahinta waa sida soo socota:

• calaamatul cajaa'ib !
• oo ay ku xigto garab labajibbaaran oo leh qoraalka alt ee sawirka
• Dabadeed garab caadi ah, geli URL-ka sawirka gudaha, oo ugu dambayntii ku duub xigashooyin oo ku dar qoraal 'ciwaan' ikhtiyaari ah.

Sawirka tixraaca wuxuu u egyahay sidan:

![Alt text][id]

"id" waa magaca tixraaca sawirka, kaas oo loo qeexay si la mid ah tixraaca xiriirinta:

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

Ilaa hadda, Markdown ma laha hab lagu cayimo ballaca iyo dhererka sawirka, haddii aad u baahato, waxaad isticmaali kartaa sida caadiga ah. <img> Summada

其它

isku xirka auto

Markdown waxa ay taageertaa habaynta URL-yada iyo iimaylada qaab xidhiidhin toos ah oo gaagaaban.Ilaa inta ay ku xidhan yihiin xagalka xagasha, Markdown waxa uu si toos ah u rogi doonaa isku xidhkaQoraalka isku xirka URL-ka guud wuxuu la mid yahay ciwaanka isku xirka, tusaale ahaan:

<http://example.com/>

Markdown waxa loo rogi doonaa:

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

Isku xirka tooska ah ee ciwaannada iimaylka ayaa sidoo kale la mid ah, marka laga reebo in Markdown uu marka hore samayn doono hab beddelka codaynta, oo u beddelaya xarfaha qoraalka qaybo HTML ah. Qaabkani waxa uu khiyaami karaa qaar ka mid ah aaladaha ururinta cinwaanka iimaylka xun, sida:

<[email protected]>

Markdown ayaa isu rogi doonta:

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

Gudaha browserka, xadhigan (dhab ahaantii <a href="mailto:[email protected]">[email protected]</a>) wuxuu noqdaa iskuxiraha "[email protected]" la gujin karo.

(Inkasta oo habkani uu khiyaami karo robots badan, ma joojin karo dhamaantood, laakiin way ka fiican tahay waxba. Xaalad kasta, furitaanka sanduuqaaga boostada ayaa ugu dambeyntii soo jiidan doona waraaqaha xayaysiinta.)

dib u dhac

Markdown waxay isticmaali kartaa dib-u-celinta si ay u geliso calaamado macnayaal kale leh naxwaha, tusaale ahaan: haddii aad rabto inaad ku darto calaamad ku xigta qoraalka si aad xoogga u saarto (laakin maya <em> tag), waxaad kaga hor mari kartaa xidigta adigoo dib u celinaya:

\*literal asterisks\*

Markdown waxa ay taageertaa calaamadaha soo socda ee ay ka horreeyaan dib-u-dhac si ay gacan uga geysato gelinta calaamadaha guud:

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

Markdown free editor

Madal Windows

• MarkdownPad
• MarkPad

madal Mac

• Mou

tifaftiraha online

• MPEditor

plugin browser

• Markdown halkan plugin

*** Haddii uu jiro tafatire Markdown ka fiican oo bilaash ah oo lagu talinayo, fadlan fiiro gaar ah u yeelo jawaab celintaChen Weiliang,mahadsanid!