Wateya Markdown çi ye? Meriv çawa nîşankirina hevoksaziya Markdown/formatkirinê bikar tîne?

MarkdownWateya çi?

Meriv çawa nîşana hevoksaziya Markdown/formatkirinê bikar tîne?

Têgihiştinî

Markdown zimanek nîşankirina sivik e ku ji hêla John Gruber ve hatî afirandin.

Ew dihêle ku mirov "belgeyên bi rengek nivîsê ya sade ku xwendin û nivîsandina wê hêsan e binivîsin, û dûv re wan veguherînin belgeyên derbasdar ên XHTML (an HTML).

Ziman gelek taybetmendiyên nîşankirina nivîsa sade ya ku berê di e-nameyê de hatine dîtin vedihewîne.

John Gruber di sala 2004-an de, bi hevkariya Aaron Swartz, bi beşekî mezin li ser hevoksaziyê, zimanê Markdown afirand.Armanca ziman ew e ku "formatek nivîsê ya sade ku bi hêsanî were xwendin, hêsan were nivîsandin û vebijarkî veguhezîne XHTML (an HTML) derbasdar" bikar bîne.

armanc

Armanca Markdown ew e ku "hêsan were xwendin û hêsan were nivîsandin".

xwendin, bi her awayî bikinKirrûbirra Înternetê, ezmûna bikarhêner pir girîng e.

Belgeyek ku di Markdown de hatî nivîsandin divê bikaribe rasterast bi nivîsa sade were weşandin, û nabe ku ji gelek nîşanan an rêwerzên formatkirinê pêk were.

Hevoksaziya Markdown ji hêla hin formên nivîs-to-HTML-ê yên heyî ve tê bandor kirin, di nav de Setext, atx, Textile, reStructuredText, Grutatext, û EtText, lê çavkaniya herî mezin a îlhamê forma e-nameya nivîsê ya sade ye.

Bi kurtasî, hevoksaziya Markdown hemî ji sembolan pêk tê, ku bi baldarî têne hilbijartin û fonksiyonên wan bi çavekî zelal in.Mînak: stêrk li dora nivîsê bixin da ku ew mîna *tengasiyê* xuya bike.

Lîsteyên di Markdown de mîna navnîşan xuya dikin. Blockquotes di Markdown de bi rastî mîna ku we di e-nameyê de dîtiye, mîna vegotina perçeyek nivîsê xuya dike.

Bi HTML-ê re hevaheng e

Armanca rêzimanê Markdown ew e ku ji bo tevnê bibe zimanek nivîsandinê.

Markdown nayê mebesta ku şûna HTML-ê bigire, an jî nêzikî wê bibe, ew pir hindik guhertoyên hevoksaziyê hene û tenê bi jêrkomek piçûk a nîşankirina HTML-ê re têkildar e. Markdown nehate fikirîn ku nivîsandina belgeyên HTML-ê hêsantir bike.

Bi dîtina min, HTML jixwe nivîsandina hêsan e. Fikra Markdown ev e ku xwendina belgeyan, nivîsandin û guheztina bi kêfa xwe hêsantir bike. HTML formatek weşanê ye, Markdown acopywritingforma nivîskî.Bi vî rengî, hevoksaziya formatkirina Markdown tenê tiştê ku nivîsara sade dikare vedigire.

Etîketên ku ji hêla Markdown ve nehatine vegirtin, dikarin rasterast di belgeyê de bi HTML-ê bêne nivîsandinPêşkêşkirina Webêkopî.Ne hewce ye ku vê yekê wekî HTML an Markdown nîşan bikin; tenê rasterast nîşankirinê lê zêde bikin.

Tenê hin hêmanên bloka HTML-ê têne asteng kirin - wek <div>,<table>,<pre>,<p> û etîketên din, divê ew ji deverên naverokê yên din bi xêzên vala berî û paşî werin veqetandin, û divê etîketên wan ên vekirin û girtinê bi tablo û valahiyan venebin. Afirînerê Markdown têra xwe jîr e ku tagên blokên HTML-ê yên nehewce zêde neke <p> awanasî.

Mînak bi vî rengî ye, tabloyek HTML-ê li pelê Markdown zêde dike:

这是一个普通段落。

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

这是另一个普通段落。

Têbînî ku hevoksaziya formatkirina Markdown di navbera tagên bloka HTML-ê de nayê pêvajo kirin.Mînakî, heke hûn di hundurê bloka HTML-ê de şêwazek Markdown bikar bînin*强调*dê ti bandor nebe.

Etîketên beşa HTML (navdêr) wekî <span>,<cite>,<del> Di paragraf, navnîş an sernavên Markdown de dikare bi serbestî were bikar anîn.Li gorî adetên kesane, hûn dikarin tagên HTML-ê jî bêyî karanîna forma Markdown bikar bînin da ku format bikin.Mînak: Heke hûn HTML-ê tercîh dikin <a> 或 <img> etîketan, ku rasterast bêyî girêdan an hevoksaziya nîşana wêneyê ku ji hêla Markdown ve hatî peyda kirin têne bikar anîn.

Berevajî etîketên bloka HTML-ê, hevoksaziya Markdown di navbera etîketên beşa HTML-ê de derbasdar e.

Veguheztina otomatîkî ya karakterên taybetî

Di pelên HTML-ê de, du tîp hene ku hewceyê destwerdana taybetî ne: < 和 & . < sembol ji bo tagên destpêkê têne bikar anîn,& Sembolan ji bo nîşankirina hebûnên HTML-ê têne bikar anîn, heke hûn tenê dixwazin prototîpa van tîpan nîşan bidin, divê hûn forma hebûnê bikar bînin, mîna < 和 &.

& Karakterên bi taybetî ji bo nivîskarên belgeyên malperê êşkêş in, ger hûn ê binivîsin "AT&T", divê hûn binivîsin"AT&T".dema ku di URL-ê de ye & Karakter jî têne guhertin.Mînakî hûn dixwazin pê ve girêdin:

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

Pêdivî ye ku hûn veguherîna URL-ê wekî binivîsin:

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

ku di etîketa girêdanê de were danîn href di milkan de.Ne hewce ye ku were gotin, ev yek hêsan e ku meriv paşguh bike, û dibe ku hejmara herî mezin a xeletiyên ku ji hêla erêkirina standardên HTML-ê ve hatine tespît kirin.

Markdown dihêle hûn karakteran bi xwezayî binivîsin, û ew bala xwe dide tiştê ku divê were veguheztin.heke hûn bikar bînin & Karaktera beşek ji karakterek HTML-ê ye, wekî ku tê hiştin, wekî din ew tê veguheztin &;.

Ji ber vê yekê heke hûn dixwazin sembolek mafê kopîkirinê têxin belgeyê ©, hûn dikarin binivîsin:

©

Markdown wê bêkêmasî bihêle.Û eger hûn binivîsin:

AT&T

Markdown wê veguherîne:

AT&T

Di heman demê de rewşek bi vî rengî jî diqewime < nîşankirin, ji ber ku Markdown destûrê dide lihevhatina HTML-ê, heke hûn danîn < Sembolan ji bo tagên HTML-ê wekî dabeşker têne bikar anîn, û Markdown dê li ser wan veguherînan neke, lê heke hûn binivîsin:

4 < 5

Markdown wê veguherîne:

4 < 5

Lêbelê, divê bête zanîn ku di çarçoveya kodê de, gelo ew di hundurê de ye an blokê ye, < 和 & herdu sembolhetmentêne veguherandin hebûnên HTML-ê, taybetmendiyek ku dihêle hûn bi hêsanî koda HTML-ê di Markdown de binivîsin (berevajî HTML-ê, ku hûn li wir hemî < 和 & Ji bo ku di pelê HTML-ê de koda HTML-ê binivîsin, hemî di nav dezgehên HTML-ê de têne veguheztin. )

hêmana blokê

Paragraf û rêzikên şikestî

Paragrafek Markdown ji yek an çend rêzikên nivîsê yên li pey hev pêk tê, li pêş û dûv wê bêtir ji rêzek vala (pênaseya xêzek vala ew e ku ew li ser ekranê vala xuya dike û wekî xetek vala tê hesibandin. Mînak, , heke xêzek tenê cîh û tabloyan hebe, dê rêz jî wekî xêzek vala were hesibandin).Divê paragrafên normal bi valahî an tabloyan venebin.

Gotina "ji yek an çend rêzikên nivîsê yên li pey hev pêk tê" bi rastî tê vê wateyê ku Markdown destûrê dide xetên nû yên bi zorê (têxistina xetên nû) di nav paragrafan de, taybetmendiyek ku ji pir formên din ên nivîs-to-HTML-ê cûda ye (di nav de Tîpa Movable "Veguhastina Veqetandina Xetê " vebijêrk), formatên din dê her şikestina rêzê veguherînin <br /> awanasî.

Hûn û ezbirastîDixwazin xwe bispêrin Markdown ku têxin <br /> Ji bo etîketan, du an zêdetir cihan li cîhê têketinê bikirtînin û dûv re Enter bikirtînin.

Bi rastî, ji bo hilberandinê xebatek piçûktir (cihên pêvek) hewce dike <br /> , lê bi tenê "her xêza nû tê veguheztin <br />"Rêbaz di Markdown de, ew di Markdown de ne maqûl eaiÇîrokên blokên bi şêwaza L û navnîşên pir-paragrafî ne tenê bikêrtir in, lê di heman demê de xwendina bi tîpên bi veqetandina rêzan jî hêsantir in.

Sernav

Markdown ji bo sernavan du hevoksaziyan piştgirî dike, Setext-wek û atx-wek.

Forma Settext-wek forma bi rêza jêrîn e, bi kar tîne = (navê herî bilind) û - (Sernivîsên rêza duyemîn), mînakî:

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

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

her mîqdara = 和 - dikare bi bandor be.

Forma mîna Atx-ê ji 1 heta 6-ê di destpêka rêzê de vedigire # , bi sernavên 1 heta 6 re têkildar e, wek nimûne:

# 这是 H1

## 这是 H2

###### 这是 H6

Hûn dikarin vebijarkî sernivîsên mîna atx-ê "nêzîk" bikin, ev tenê ji bo estetîkê ye, heke hûn bi vî rengî xwe rehet hîs bikin, hûn dikarin wê li dawiya rêzê lê zêde bikin. #, dema ku rêz diqede # Ne hewce ye ku hejmar wekî destpêkê be (hejmara tîpên poundî yên di destpêka rêzê de rêza sernavê diyar dike):

# 这是 H1 #

## 这是 H2 ##

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

Blockquotes Blockquotes

Blokên nîşankirinê yên Markdown mîna yên ku di e-nameyê de têne bikar anîn têne bikar anîn > ji navdêran.Ger hûn bi tîpên bi tîpên e-nameyê dizanin, hûn dizanin ka meriv çawa di pelek Markdown de blokê biafirîne, ku wusa xuya dike ku hûn bi xwe rêzan bişkînin, dûv re lê zêde bikin. > :

> 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 di heman demê de dihêle hûn tembel bin û tenê rêza yekem a tevahiya paragrafê lê zêde bikin > :

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

Referansên blokê dikarin bi hêlînek (mînak: referansên di nav referansan de) bi lêzêdekirina jimareyek cûda werin hêlîn kirin > :

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

Hevoksaziyên din ên Markdown jî dikarin di nav blokên binavkirî de werin bikar anîn, tevî sernav, navnîş, blokên kodê, hwd.:

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

Her edîtorek nivîsê ya hêja dikare bi hêsanî navgînên şêwaza e-nameyê biafirîne.Mînakî di BBEdit de hûn dikarin nivîsê hilbijêrin û dûv re ji menuê hilbijêrinhiyerarşiya vegotinê zêde bike.

Navnîş kirin

Markdown navnîşên rêzkirî û nerêkûpêk piştgirî dike.

Lîsteyên ne rêzkirî stêrk, nîşaneyên zêde, an nîşanên kêm wekî nîşankerên navnîşê bikar tînin:

*   Red
*   Green
*   Blue

Wekhevî:

+   Red
+   Green
+   Blue

Her weha wekhev e:

-   Red
-   Green
-   Blue

Lîsteyên rêzkirî jimareyan bi dûmahîkê bikar tînin:

1.  Bird
2.  McHale
3.  Parish

Girîng e ku hûn bala xwe bidinê ku hejmarên ku hûn di navnîşa navnîşê de bikar tînin bandorê li HTML-a derketinê nakin. Nîşana HTML-ê ya ku ji bo navnîşa jorîn tête encamdan dê bibe:

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

Ger nîşana navnîşa we wekî hatî nivîsandin:

1.  Bird
1.  McHale
1.  Parish

yan jî:

3. Bird
1. McHale
8. Parish

Hûn ê her du jî tam heman derana HTML-ê bistînin.Mesele, hûn dikarin jimareyên navnîşê yên di pelê Markdown de wekî encamên derketinê bikin, an heke hûn tembel in, ne hewce ye ku hûn qet li ser rastbûna jimareyan xem bikin.

Heke hûn nivîsandina tembel bikar tînin, tê pêşniyar kirin ku ji bo babeta yekem bi 1. dest pê bikin, ji ber ku Markdown dibe ku di pêşerojê de taybetmendiya destpêkê ya navnîşên rêzkirî piştgirî bike.

Nîşana babeta lîsteyê bi gelemperî li milê çepê yê dûr tê danîn, lê ew dikare heya 3 valahiyan were veqetandin, û divê etîketa babetê bi kêmî ve valahiyek an tabloyek were şopandin.

Ji bo ku navnîş xweştir xuya bike, hûn dikarin naverokê bi xêzek sabît organîze bikin:

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

Lê heke hûn tembel in, ew jî baş e:

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

Ger tiştên lîsteyê bi xêzên vala werin veqetandin, Markdown dê dema ku HTML-ê derdixe naverokê bikar bîne. <p> Etîket têne pêçandin, mînakî:

*   Bird
*   Magic

dê were veguheztin:

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

Lê ev:

*   Bird

*   Magic

dê were veguheztin:

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

Tiştên lîsteyê dikarin çend paragrafan hebin, û paragrafên di binê her babetekê de divê bi 4 valahiyan an jî 1 tabekê werin veqetandin:

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.

Ger hûn her rêzê bişkînin pir çêtir xuya dike, bê guman, dîsa, heke hûn tembel bin, Markdown jî destûrê dide:

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

Ger hûn dixwazin referansek di hundurê tomarek navnîşê de bixin, wê hingê > Pêdivî ye ku ew were veqetandin:

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

Ger hûn dixwazin bloka kodê bixin, pêdivî ye ku blok were veqetandindu car, ku 8 cih an 2 tabloyan e:

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

        <代码写在这>

Bê guman, navnîşek tiştan dikare bi xeletî were çêkirin, tiştek mîna vê:

1986. What a great season.

Bi gotineke din, ew di destpêka rêzê de xuya dikejimar-serdem-vala, ji bo ku hûn ji vê yekê dûr nekevin, hûn dikarin berî heyamê paşvekêşek lê zêde bikin.

1986\. What a great season.

bloka kodê

Koda çavkaniyê ya nivîsandina bi bernameyê an jî zimanê etîketê bi gelemperî jixwe blokên kodê yên tîpkirî hene. Bi gelemperî, em naxwazin ku ev blokan di awayê pelên paragrafê yên gelemperî de werin celeb kirin, lê wan wekî ku ne nîşan bidin. Markdown dê bikar bîne <pre> 和 <code> etîketên ku blokên kodê bipêçin.

Avakirina blokên kodê di Markdown de bi qasî 4 cihan an 1 tabloyê veqetandî hêsan e, mînakî, jêrîn têkevin:

这是一个普通段落：

    这是一个代码区块。

Markdown dê veguherîne:

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

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

Ev xêzkirina rêza yekem a her rêzê (4 cih an 1 tablo) tê rakirin, mînak:

Here is an example of AppleScript:

    tell application "Foo"
        beep
    end tell

dê were veguheztin:

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

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

Blokek kodê heya xêza nevekirî (an dawiya pelê) berdewam dike.

Di hundurê bloka kodê de, & , < 和 > Ew ê bixweber veguhere hebûnên HTML-ê. Ev rêbaz ji we re pir hêsan dike ku hûn Markdown bikar bînin ku ji bo nimûne koda çavkaniyê ya HTML-ê têxin nav xwe, tenê wê kopî bikin û bişopînin, veqetandinê lê zêde bikin, û yên mayî Markdown wê ji we re bixebitîne, ji bo mînak:

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

dê were veguheztin:

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

Di bloka kodê de, hevoksaziya giştî ya Markdown dê neyê veguheztin, wekî stêrk tenê stêrk in, ku tê vê wateyê ku hûn dikarin bi hêsanî pelên têkildar ên hevoksaziya Markdown di hevoksaziya Markdown de binivîsin.

dabeşker

Hûn dikarin bi sê stêrk, nîşaneyên kêm, binî di rêzekê de, di rêzê de tiştek din dabeşkerek biafirînin.Her weha hûn dikarin ciyên di navbera stêrkan an nîşanên kêman de jî têxin.Rêzên veqetandinê dikarin di her yek ji awayên jêrîn ên nivîsandinê de werin afirandin:

* * *

***

*****

- - -

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

hêmana beşa

pêvek

Markdown du formên hevoksaziya girêdanê piştgirî dike: Inline和Balkêşîdu form.

Bi her awayî, nivîsa lînkê bi [brayên çargoşe] tê nîşankirin.

afirandin aInlineHeke hûn dixwazin metna sernavê ya lînkê lê zêde bikin, tenê li dû URL-ê nivîsa sernavê bi nîşaneyên ducarî bipêçin, mînakî:

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

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

Dê hilberîne:

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

Ger hûn çavkaniyên li ser heman mêvandar ve girêdidin, hûn dikarin riyên têkildar bikar bînin:

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

BalkêşîLi dû lînkê li dû paranteza metna lînkê bendek çargoşeyek din tê peyda kirin, û nîşana ku ji bo nasandina lînkê tê bikar anîn divê di kembera çargoşeya duyemîn de were dagirtin:

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

Her weha hûn dikarin vebijarkî navberek di navbera her du berikên çargoşe de bixin:

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

Dûv re, li her cîhê pelê, hûn dikarin naveroka lînkê ya vê tagê diyar bikin:

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

Naveroka girêdanê di formê de tête diyar kirin:

• Kûçikên çargoşe (bi bijarteyî bi sê cihan ji bo vegirtinê têne pêş) ku nivîsa lînkê tê de tê nivîsandin
• dûv re kolonek
• li dûv yek an jî çend cih an tab
• URL ya girêdana paşîn
• Bi bijartî li ser naveroka sernavê bişopînin, ku dikare di nav quotes yekane, ducaran, an parantezê de were girtin

Pênaseyên sê girêdanên jêrîn yek in:

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

baldaynî:Pirsgirêkek naskirî heye ku Markdown.pl 1.0.1 sernavên zencîreyê yên ku di nav lêkerên yekane de hatine girtin paşguh dike.

URLên lînkê jî dikarin di nav kevokên goşeyê de bêne girtin:

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

Her weha hûn dikarin taybetmendiya sernavê li ser rêza paşîn bixin, an jî hin vegirtinê lê zêde bikin, ku ger URL pir dirêj be dê çêtir xuya bike:

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

Danasîna URL tenê dema ku zencîre çêdibe tê bikar anîn, û rasterast di pelê de xuya nake.

Dibe ku etîketên nasnameya girêdanê tîp, jimar, cîhê spî, û xalbendî hebin, lê nabinNaEw hesas e, ji ber vê yekê du girêdanên jêrîn yek in:

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

Etîketa girêdana nepenîtaybetmendî destûrê dide te ku hûn tagek lînkek diyar nekin. Di vê rewşê de, etîketa lînkê dê wekî metna lînkê wekhev were hesibandin. Ji bo ku tagek lînkek nepenî bikar bînin, tenê li dû metna lînkê bendek çargoşeya vala lê zêde bikin. Heke hûn dixwazin "Google " Girêdana bi google.com re, hûn dikarin hêsan bikin:

[Google][]

Piştre naveroka girêdanê diyar bikin:

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

Ji ber ku nivîsa lînkê dibe ku cîhê spî hebe, ev nîşankirina hêsan dibe ku gelek peyvan hebe:

Visit [Daring Fireball][] for more information.

Dûv re herin pênasekirina girêdanê:

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

Pênaseya lînkê dikare li her derê pelê were danîn. Ez tercîh dikim ku rasterast li dû paragrafa ku lînka lê xuya dike bixim. Her weha hûn dikarin wê li dawiya pelê, mîna şîroveyek, bixin.

Li vir mînakek girêdanek referansê ye:

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"

Ger hûn wê biguhezînin da ku navê girêdanê bikar bînin da ku binivîsin:

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"

Du awayên jorîn ên nivîsandinê dê HTML-a jêrîn hilberînin.

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

Li jêr pelê Markdown-ê ya heman naverokê ye ku bi navgîniyê hatî nivîsandin, ji bo berhevdanê hatî peyda kirin:

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

Bi rastî, xala lînkên şêwaza referansê ne ew e ku nivîsandina wê hêsantir e, lê ew e ku hêsantir e. 81 tîp, heke bi HTML-ya safî were nivîsandin dê 176 tîp hebin.Di formata HTML-ê de ji nivîsê bêtir etîket hene.

Bi karanîna girêdanên şêwaza referansê ya Markdown, hûn dikarin belgeyê bêtir wekî encama dawîn a gerokê bikin, bihêle ku hûn hin metadatayên girêdayî nîşankirinê li derveyî metna paragrafê biguhezînin, û hûn dikarin bêyî ku hesta xwendinê ya gotarê çêkin lînkan lê zêde bikin. navber .

Bidengkirin

Markdown stêrkan bikar tîne (*) û xeta jêrîn (_) wekî sembola ku bêjeyeke binxêzkirî nîşan dide, ye * 或 _ Peyvên dorpêçkirî têne veguherandin <em> dor bi etîketan, bi du * 或 _Ger were pêçandin, dê were veguheztin <strong>, Mînak:

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

dê veguhere:

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

Hûn dikarin her şêwazê ku hûn jê hez dikin bikar bînin, tenê sînorkirin ev e ku hûn dikarin bi kîjan nîşana ku hûn dixwazin wê biqedînin etîketê vekin.

Zehf dikare rasterast di nîvê nivîsê de jî were danîn:

un*frigging*believable

lebêheke we * 和 _ Ger li her du aliyan valahiyek spî hebe, ew tenê wekî sembolên normal têne hesibandin.

Ji bo têxistina stêrkên normal an jî binî rasterast li pêş û piştî nivîsê, hûn dikarin paşpirtikan bikar bînin:

\*this text is surrounded by literal asterisks\*

Navê dizî

Heke hûn dixwazin perçeyek piçûk a koda hundurîn nîşan bikin, hûn dikarin wê di paşkêşan de bipêçin (`), Mînak:

Use the `printf()` function.

Dê hilberîne:

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

Heke hûn dixwazin paşkêşan têxin hundurê beşek kodê, hûn dikarin beşa kodê bi gelek paşkêşan dest pê bikin û biqedînin:

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

Ev hevoksazî çêdike:

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

Hûn dikarin valahiyek li destpêk û dawiya beşê kodê, yek li dû destpêkê û yek jî berî dawiyê deynin, ji ber vê yekê hûn dikarin paşpirtikan li destpêka beşê têxin:

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

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

Dê hilberîne:

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

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

Di hundurê beşa kodê de,& û kelepên goşeyê都dê bixweber veguhezîne saziyên HTML-ê, ku têxistina koda çavkaniya HTML-ê hêsan dike, Markdown dê paragrafa jêrîn deyne:

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

ber:

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

Hûn dikarin vê jî binivîsin:

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

Ji bo hilberînê:

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

图片

Eşkere ye, ji bo têxistina wêneyan di serîlêdanek tenê nivîsê de sêwirana hevoksaziyek "xwezayî" dijwar e.

Markdown hevoksaziyek mîna ya girêdanan bikar tîne da ku wêneyan nîşan bide, û di heman demê de destûrê dide du şêwazan: Inline和Balkêşî.

Hevoksaziya wêneya hundurîn weha xuya dike:

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

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

Agahiyên berfireh wiha ne:

• nîşanek derbirînê !
• dûv re çargoşeyek bi nivîsa alt ji bo wêneyê
• Li dûv wê parantezên normal bi URL-ya wêneyê re, û di dawiyê de nivîsek 'sernavê' ya bijarte ya ku di nav nîgaran de tê girtin tê.

Hevoksaziya wêneya referansê wiha xuya dike:

![Alt text][id]

"id" navê referansa wêneyê ye, ku bi heman rengî wekî referansa girêdanê tête diyar kirin:

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

Heya nuha, Markdown rêyek tune ku firehî û bilindahiya wêneyê diyar bike, ger hewce bike, hûn dikarin normal bikar bînin. <img> awanasî.

Din

girêdana otomatîk

Markdown piştgirîya hilberandina URL û qutiyên posta e-nameyê di şiklê girêdanên otomatîkî yên nisbeten kurt de dike. Heya ku ew di quncikên goşeyê de bin, Markdown dê bixweber wê veguhezîne lînkê.Nivîsara girêdanê ya URL-ya gelemperî wekî navnîşana girêdanê ye, mînakî:

<http://example.com/>

Markdown dê veguhere:

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

Girêdana otomatîkî ya navnîşanên e-nameyê jî dişibihe, ji bilî ku Markdown dê pêşî pêvajoyek veguheztina kodkirinê pêk bîne, tîpên nivîsê vediguherîne hebûnên HTML-ê yên hexadecimal. Ev format dikare hin robotên berhevkirina navnîşana e-nameyê xirab bixapîne, wek:

<[email protected]>

Markdown dê bibe:

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

Di gerokê de, ev rêzik (bi rastî <a href="mailto:[email protected]">[email protected]</a>) dibe lînka klîk "[email protected]".

(Tevî ku ev nêzîkatî dikare gelek robotan bixapîne jî, ew nikare wan hemîyan rawestîne, lê ew ji tiştek çêtir e. Di her rewşê de, vekirina qutiya posta xwe dê di dawiyê de nameyên reklamê bikişîne.)

paşvekêşana

Markdown dikare paşkêşkêşan bikar bîne da ku sembolên ku wateyên wan ên din di rêzimanê de hene, bi kar bîne, mînakî: heke hûn dixwazin stêrkek li tenişta nivîsê ji bo giraniyê zêde bikin (lê na <em> etîket), hûn dikarin stêrkê bi paşvekêşkek bidin pêş:

\*literal asterisks\*

Markdown sembolên jêrîn ên ku li pêş wan paşvekêşkek heye piştgirî dike da ku alîkariya danasîna sembolên hevpar bike:

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

edîtorê belaş Markdown

Platforma Windows

• MarkdownPad
• MarkPad

platform Mac

• nerm

edîtorê serhêl

• MPEditor

pêveka gerokê

• Pêveka li vir nîşankirin

*** Ger edîtorek Markdown-a belaş çêtir heye ku pêşniyar bike, ji kerema xwe bala xwe bidin bersivêChen Weiliang,spas!