Cad a chiallaíonn Markdown? Conas comhréir Markdown/marcáil formáidithe a úsáid?

MarkdownCad a chiallaíonn?

Conas comhréir Markdown/marcáil formáide a úsáid?

Forbhreathnú

Teanga mharcála éadrom is ea Markdown a chruthaigh John Gruber.

Ligeann sé do dhaoine “doiciméid a scríobh i bhformáid gnáth-théacs atá éasca le léamh agus a scríobh, agus ansin iad a thiontú ina ndoiciméid bhailí XHTML (nó HTML).

Cuimsíonn an teanga go leor de na gnéithe de mharcáil gnáth-théacs atá le fáil cheana féin sa ríomhphost.

Chruthaigh John Gruber an teanga Markdown sa bhliain 2004, i gcomhar le Aaron Swartz go mór ar an gcomhréir.Is é cuspóir na teanga "formáid gnáth-théacs atá éasca le léamh, éasca le scríobh, agus a thiontaíonn go XHTML (nó HTML)) bailí go roghnach a úsáid".

cuspóir

Is é an sprioc atá ag Markdown ná a bheith “éasca le léamh agus éasca le scríobh”.

inléiteacht, déan é ar aon nósMargaíocht Idirlín, tá an taithí úsáideora an-tábhachtach.

Ba cheart go bhféadfaí comhad atá scríofa in Markdown a fhoilsiú go díreach i ngnáth-théacs, agus níor cheart go mbeadh an chuma air go bhfuil go leor clibeanna nó treoracha formáidithe ann.

Bíonn tionchar ag roinnt formáidí téacs-go-HTML atá ann cheana féin ar chomhréir Markdown, lena n-áirítear Setext, atx, Textile, ReStructuredText, Grutatext, agus EtText, ach is í an fhormáid ríomhphoist gnáth-théacs an fhoinse inspioráide is mó.

I mbeagán focal, tá comhréir Markdown go léir comhdhéanta de shiombailí, a roghnaítear go cúramach agus sracfhéachaint ar a bhfeidhmeanna.Mar shampla: cuir réiltíní timpeall an téacs le go mbeidh cuma *béim* air.

Breathnaíonn liostaí i Markdown cosúil le liostaí, mar sin de. Is cosúil go luann Blockquotes in Markdown píosa téacs a lua, mar a chonaic tú i ríomhphoist.

Ag luí le HTML

Is é an sprioc atá ag gramadach Markdown ná a bheith ina teanga scríbhneoireachta don ngréasán.

Níl sé i gceist Markdown a chur in ionad HTML, nó fiú teacht gar dó, is beag comhréir atá aige agus ní fhreagraíonn sé ach d'fhothacar beag marcála HTML. Níor ceapadh Markdown chun doiciméid HTML a dhéanamh níos éasca le scríobh.

Is é mo thuairim go bhfuil HTML éasca le scríobh cheana féin. Is é an smaoineamh atá ag Markdown ná doiciméid a dhéanamh níos éasca le léamh, le scríobh, agus le hathrú de réir toil. Is formáid foilsitheoireachta é HTML, is Markdown aCóipscríbhneoireachtformáid scríofa.Mar sin, ní chlúdaíonn comhréir formáidithe Markdown ach an méid is féidir le gnáth-théacs.

Is féidir clibeanna nach bhfuil clúdaithe ag Markdown a scríobh i HTML go díreach sa doiciméadCur Chun Cinn Gréasáincóip.Ní gá é seo a mharcáil mar HTML nó Markdown; ní gá ach an marcáil a chur leis go díreach.

Ní gá ach roinnt bloc-eilimintí HTML a shrianadh - mar shampla <div>,<table>,<pre>,<p> agus clibeanna eile, ní mór iad a dheighilt ó réimsí ábhair eile le línte bána roimh agus ina dhiaidh, agus ní féidir a gclibeanna oscailte agus dúnta a eangú le cluaisíní nó spásanna. Tá an gineadóir Markdown cliste go leor gan clibeanna bloc HTML gan ghá a chur leis <p> lipéad.

Seo a leanas an sampla, ag cur tábla HTML leis an gcomhad Markdown:

这是一个普通段落。

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

这是另一个普通段落。

Tabhair faoi deara nach ndéanfar comhréir formáidithe Markdown idir clibeanna bloc HTML a phróiseáil.Mar shampla, má úsáideann tú stíl Markdown taobh istigh de bhloc HTML*强调*ní bheidh aon éifeacht.

Clibeanna alt HTML (inlíne) mar <span>,<cite>,<del> Is féidir é a úsáid faoi shaoirse i míreanna Markdown, liostaí nó ceannteidil.De réir nósanna pearsanta, is féidir leat fiú clibeanna HTML a úsáid chun formáid gan úsáid a bhaint as formáid Markdown.Sampla: Más fearr leat HTML <a> Nó <img> clibeanna, ar féidir iad a úsáid go díreach gan an nasc nó an chomhréir chlib íomhá a sholáthraíonn Markdown.

Murab ionann agus idir clibeanna bloc HTML, tá comhréir Markdown bailí idir clibeanna alt HTML.

Comhshó uathoibríoch de charachtair speisialta

I gcomhaid HTML, tá dhá charachtar a dteastaíonn láimhseáil speisialta uathu: < 和 & . < úsáidtear siombailí le haghaidh clibeanna tosaigh,& Úsáidtear siombailí chun aonáin HTML a mharcáil, más mian leat fréamhshamhail na gcarachtar seo a thaispeáint, caithfidh tú foirm an aonáin a úsáid, mar shampla < 和 &.

& Tá carachtair ag déanamh crá go háirithe do scríbhneoirí doiciméad gréasáin, má tá tú chun clóscríobh "AT&T", caithfidh tú scríobh"AT&T“.agus tú sa URL & Tiontaítear carachtair freisin.Mar shampla ba mhaith leat nasc a dhéanamh le:

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

Caithfidh tú an tiontú URL a scríobh mar:

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

a chur sa chlib nasc href in airíonna.Ní gá a rá, tá sé seo éasca neamhaird a dhéanamh, agus is dócha gurb é an líon is mó earráidí a aimsíodh le bailíochtú caighdeáin HTML.

Ligeann Markdown duit carachtair a scríobh go nádúrtha, agus tugann sé aire do na rudaí is gá a thiontú.má úsáideann tú & Is cuid d’aonán carachtar HTML é carachtar, fágtar é mar atá, mura dtiontaítear é &;.

Mar sin más mian leat siombail chóipchirt a chur isteach sa doiciméad ©, is féidir leat scríobh:

©

Fágfaidh Markdown gan teagmháil leis.Agus má scríobhann tú:

AT&T

Déanfaidh Markdown é a thiontú go:

AT&T

Tarlaíonn cás den chineál céanna freisin i < nodaireacht, ós rud é go gceadaíonn Markdown comhoiriúnacht HTML, má chuireann tú < Úsáidtear siombailí mar theorainneacha le haghaidh clibeanna HTML, agus ní dhéanfaidh Markdown aon tiontuithe orthu, ach má scríobhann tú:

4 < 5

Déanfaidh Markdown é a thiontú go:

4 < 5

Mar sin féin, ba chóir a thabhairt faoi deara, laistigh de raon feidhme an chóid, cibé an bhfuil sé inlíne nó bloc, < 和 & an dá shiombailcaithfidha thiontú go haonáin HTML, gné a ligeann duit cód HTML a scríobh go héasca i Markdown (seachas HTML, áit ar chuir tú na < 和 & Déantar iad go léir a thiontú go haonáin HTML, chun cód HTML a scríobh sa chomhad HTML. )

eilimint bloc

Ailt agus briseadh líne

Is éard atá i mír Markdown líne amháin nó níos mó de théacs as a chéile, agus níos mó ná líne bhán amháin roimhe agus ina dhiaidh (is é an sainmhíniú ar líne bhán gur dealraitheach go bhfuil sí folamh ar taispeáint agus go meastar gur líne bhán í. Mar shampla, , mura bhfuil ach spásanna agus cluaisíní i líne, déileálfar leis an líne mar líne bhán freisin).Níor cheart gnáthphíosaí a eangú le spásanna nó le cluaisíní.

Ciallaíonn an frása "Cuimsíonn an frása téacs amháin nó níos mó as a chéile" go gceadaíonn Markdown briseadh líne éigeantais (línte nua a chur isteach) laistigh d'ailt, gné atá difriúil ó fhormhór na bhformáidí téacs-go-HTML eile (lena n-áirítear Cineál Sochorraithe "Tiontú Líne Sosanna”), déanfaidh formáidí eile gach briseadh líne a thiontú go <br /> lipéad.

Má tá túcínteAg iarraidh a bheith ag brath ar Markdown a chur isteach <br /> Le haghaidh lipéid, brúigh dhá spás nó níos mó ag an áit ionsáite agus ansin brúigh Iontráil.

Go deimhin, tógann sé beagán níos mó oibre (spásanna breise) a ghiniúint <br /> , ach go simplí "tiontaítear gach nualíne go <br />“Níl an modh oiriúnach i Markdown, em i MarkdownaiNí hamháin go bhfuil bloc-quotes de stíl L agus liostaí ilmhíreanna níos úsáidí ach is fusa iad a léamh freisin agus iad ag clóchur le briseadh líne.

Teideal

Tacaíonn Markdown le dhá chomhréir le haghaidh ceannteidil, cosúil le Setext agus atx-mhaith.

Is é an fhoirm atá cosúil le Settext an fhoirm leis an mbunlíne, ag baint úsáide as = (teideal is airde) agus - (Ceannteidil dara hordú), mar shampla:

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

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

méid ar bith = 和 - is féidir a bheith éifeachtach.

Cuireann an fhoirm atá cosúil le Atx isteach 1 go 6 ag tús na líne # , a fhreagraíonn do cheannteidil 1 go 6, mar shampla:

# 这是 H1

## 这是 H2

###### 这是 H6

Is féidir leat ceannteidil atx-mhaith "a dhúnadh" go roghnach, níl sé seo ach le haghaidh aeistéitic, má bhraitheann tú compordach ar an mbealach seo, is féidir leat é a chur ag deireadh na líne #, agus críochnaíonn an líne # Ní gá go mbeadh an uimhir mar an gcéanna leis an tús (cinneann líon na gcarachtar punt ag tús na líne ord an teidil):

# 这是 H1 #

## 这是 H2 ##

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

Blockquotes Blockquotes

Úsáidtear bloc-sleachta marcála cosúil leis na cinn a úsáidtear sa ríomhphost > de lua.Má tá tú eolach ar shleachta i litreacha ríomhphoist, tá a fhios agat conas bloc-sleachta a chruthú i gcomhad Markdown, a mbeadh an chuma air go mbrisfeá na línte tú féin, ansin cuir leis > :

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

Ligeann Markdown duit a bheith leisciúil freisin agus gan ach an chéad líne den alt iomlán a chur leis > :

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

Is féidir blocthagairtí a neadú (m.sh.: tagairtí laistigh de thagairtí) trí uimhir dhifriúil de > :

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

Is féidir comhréireanna Markdown eile a úsáid freisin laistigh de bhlocanna luaite, lena n-áirítear ceannteidil, liostaí, bloic chóid, etc.:

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

Is féidir le haon eagarthóir téacs réasúnta luanna ar stíl ríomhphoist a chruthú go héasca.Mar shampla i BBEdit is féidir leat téacs a roghnú agus ansin a roghnú ón roghchlárordlathas lua a mhéadú.

列表

Tacaíonn Markdown le liostaí ordaithe agus neamhordaithe.

Úsáideann liostaí neamhordaithe réiltíní, móide comharthaí, nó lúide comharthaí mar mharcóirí liosta:

*   Red
*   Green
*   Blue

Coibhéiseach le:

+   Red
+   Green
+   Blue

Chomh maith leis sin comhionann le:

-   Red
-   Green
-   Blue

Úsáideann liostaí ordaithe uimhreacha agus tréimhse ina dhiaidh sin:

1.  Bird
2.  McHale
3.  Parish

Tá sé tábhachtach a thabhairt faoi deara nach gcuireann na huimhreacha a úsáideann tú ar an gclib liosta isteach ar an aschur HTML. Is é an marc HTML don liosta thuas a bheadh ​​mar thoradh air:

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

Má tá do mharcáil liosta scríofa mar:

1.  Bird
1.  McHale
1.  Parish

nó fiú:

3. Bird
1. McHale
8. Parish

Gheobhaidh tú an t-aschur HTML céanna go díreach.Is é an pointe, is féidir leat na huimhreacha liosta sa chomhad Markdown a dhéanamh mar an gcéanna leis na torthaí aschuir, nó má tá tú leisciúil, ní gá duit cúram a dhéanamh faoi cheartacht na n-uimhreacha ar chor ar bith.

Má úsáideann tú scríbhneoireacht leisciúil, moltar tosú le 1. don chéad mhír, mar go bhféadfadh Markdown tacú leis an tréith tosaigh de liostaí ordaithe sa todhchaí.

Is gnách go gcuirtear clib na míre liosta ar an bhfad ar chlé, ach is féidir é a eangú, suas le 3 spás, agus ní mór spás nó cluaisín amháin ar a laghad a bheith ag leanúint leis an gclib míre.

Chun an liosta a dhéanamh níos deise, is féidir leat an t-ábhar a eagrú le fleasc seasta:

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

Ach má tá tú leisciúil, tá sé sin ceart go leor freisin:

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

Má tá na míreanna liosta deighilte le línte bána, úsáidfidh Markdown ábhar na míre agus HTML á aschur. <p> Tá lipéid fillte, mar shampla:

*   Bird
*   Magic

déanfar é a thiontú go:

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

Ach seo:

*   Bird

*   Magic

déanfar é a thiontú go:

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

Is féidir le míreanna liosta a bheith i míreanna iolracha, agus ní mór na hailt faoi gach mír a eangú le 4 spás nó 1 chluaisín:

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.

Breathnaíonn sé i bhfad níos fearr má fhleasc tú gach líne, ar ndóigh, arís, má tá tú leisciúil, ceadaíonn Markdown freisin:

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

Más mian leat tagairt a chur taobh istigh de mhír liosta, ansin > Ní mór é a eangú:

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

Más mian leat bloc cóid a chur, ní mór an bloc a eangúfaoi ​​dhó, atá 8 spás nó 2 chluaisín:

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

        <代码写在这>

Ar ndóigh, d’fhéadfaí liosta míreanna a ghiniúint de thaisme, rud éigin mar seo:

1986. What a great season.

I bhfocail eile, tá sé le feiceáil ag tús na líneuimhir-tréimhse-bán, chun é seo a sheachaint, is féidir leat backslash a chur leis roimh an tréimhse.

1986\. What a great season.

bloc cód

Go hiondúil bíonn bloic chóid i scríbhinn a bhaineann le cláir nó le cód foinse teanga clibe atá clóscríofa cheana féin. De ghnáth, ní theastaíonn uainn go ndéanfaí na bloic seo a chlóchur ar bhealach comhaid ailt ghinearálta, ach taispeáin iad mar atá siad. Bainfidh Markdown úsáid as <pre> 和 <code> clibeanna chun bloic cód a fhilleadh.

Tá bloic thógála cód i Markdown chomh simplí le 4 spás nó 1 chluaisín a eangú, mar shampla, cuir isteach na rudaí seo a leanas:

这是一个普通段落：

    这是一个代码区块。

Tiontóidh Markdown go:

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

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

Baintear an eangú céad-ordú seo in aghaidh na líne (4 spás nó 1 chluaisín), mar shampla:

Here is an example of AppleScript:

    tell application "Foo"
        beep
    end tell

déanfar é a thiontú go:

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

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

Leanann bloc cóid ar aghaidh go dtí an líne neamhfheistithe (nó deireadh an chomhaid).

Taobh istigh den bhloc cód, & , < 和 > Déanfar é a thiontú go huathoibríoch ina aonáin HTML, rud a fhágann go bhfuil sé an-éasca duit Markdown a úsáid chun an cód foinse HTML a chur isteach don sampla, níl le déanamh ach é a chóipeáil agus a ghreamú, eangú a chur leis, agus láimhseálfaidh an chuid eile den Markdown é ar do shon, mar shampla:

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

déanfar é a thiontú go:

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

Sa bhloc cód, ní dhéanfar comhréir ghinearálta Markdown a thiontú, mar nach bhfuil i réiltíní ach réiltíní, rud a chiallaíonn gur féidir leat comhaid a bhaineann le comhréir Markdown a scríobh go héasca i gcomhréir Markdown.

roinnteoir

Is féidir leat níos mó ná trí réiltín, comharthaí lúide, béim a úsáid chun roinnteoir a chruthú i líne, rud ar bith eile sa líne.Is féidir leat freisin spásanna a chur isteach idir réiltíní nó comharthaí lúide.Is féidir línte deighilte a chruthú i ngach ceann de na bealaí scríbhneoireachta seo a leanas:

* * *

***

*****

- - -

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

eilimint alt

nasc

Tacaíonn Markdown le dhá chineál comhréire naisc: I líne和Tagairtdhá fhoirm.

Cibé bealach, marcáiltear téacs naisc le [lúibíní cearnacha].

a chruthú aI líneMás mian leat téacs teidil an naisc a chur leis, níl le déanamh ach an téacs teidil a chuimilt le comharthaí athfhriotail dúbailte tar éis an URL, mar shampla:

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

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

Táirgeoidh:

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

Má tá tú ag nascadh le hacmhainní ar an óstach céanna, is féidir leat cosáin choibhneasta a úsáid:

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

TagairtLeanann lúibín cearnach eile an nasc tar éis lúibín an téacs naisc, agus ba cheart an marc a úsáidtear chun an nasc a shainaithint a líonadh sa dara lúibín cearnach:

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

Is féidir leat spás a chur go roghnach freisin idir an dá lúibíní cearnacha:

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

Ansin, áit ar bith sa chomhad, is féidir leat ábhar naisc an chlib seo a shainiú:

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

Sainmhínítear ábhar naisc san fhoirm:

• Lúibíní cearnacha (go roghnach suas le trí spás le haghaidh eangú rompu) a gcuirtear téacs naisc isteach iontu
• ina dhiaidh sin idirstad
• agus spás nó cluaisín amháin nó níos mó ina dhiaidh sin
• URL an chéad nasc eile
• Go roghnach, lean an t-ábhar teidil, ar féidir é a chur faoi iamh i Sleachta aonair, Sleachta dúbailte, nó Lúibíní

Is mar a chéile na sainmhínithe ar na trí nasc seo a leanas:

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

rabhadh:Tá saincheist aitheanta nuair a dhéanann Markdown.pl 1.0.1 neamhaird ar theidil naisc faoi iamh i Sleachta aonair.

Is féidir URLanna naisc a chur faoi iamh idir lúibíní uillinne freisin:

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

Is féidir leat freisin an tréith teidil a chur ar an gcéad líne eile, nó roinnt eangú a chur leis, a bheidh cuma níos fearr má tá an URL ró-fhada:

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

Ní úsáidtear sainmhínithe URL ach amháin nuair a bhíonn naisc á nginiúint, agus ní bhíonn siad le feiceáil go díreach sa chomhad.

Féadfaidh litreacha, uimhreacha, spás bán agus poncaíocht a bheith i gclibeanna aitheantais naisc, ach ní gáNílTá sé cásíogair, mar sin tá an dá nasc seo a leanas mar a chéile:

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

Clib nasc intuigtheCeadaíonn an ghné seo duit clib naisc a shonrú a fhágáil ar lár. Sa chás seo, déileálfar leis an gclib naisc mar rud comhionann leis an téacs naisc. Chun clib naisc intuigthe a úsáid, níl le déanamh ach lúibín cearnach folamh a chur leis tar éis an téacs naisc. Más mian leat "Google " Ag nascadh le google.com, is féidir leat a shimpliú go:

[Google][]

Ansin sainigh ábhar an naisc:

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

Ós rud é go bhféadfadh spás bán a bheith sa téacs naisc, seans go mbeidh focail iolracha sa mharcáil simplithe seo:

Visit [Daring Fireball][] for more information.

Ansin téigh ar aghaidh chun an nasc a shainiú:

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

Is féidir an sainmhíniú ar an nasc a chur áit ar bith sa chomhad.Is fearr liom é a chur díreach tar éis na míre ina bhfuil an nasc le feiceáil.Is féidir leat é a chur ag deireadh an chomhaid freisin, díreach cosúil le trácht.

Seo sampla de nasc tagartha:

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"

Má athraíonn tú é chun ainm an naisc a úsáid chun scríobh:

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"

Cuirfidh an dá bhealach scríbhneoireachta thuas an HTML seo a leanas ar fáil.

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

Anseo thíos tá comhad Markdown den ábhar céanna scríofa inlíne, curtha ar fáil le haghaidh comparáide:

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

Go deimhin, ní hé an pointe a bhaineann le naisc stíl tagartha ná go bhfuil siad níos éasca a scríobh, ach go bhfuil siad níos éasca le léamh Déan comparáid idir an sampla thuas.Níl ach 81 carachtar san alt stíl tagartha féin, ach méadóidh an fhoirm inlíne go 176 carachtar. , má tá sé scríofa i bhformáid HTML íon, beidh carachtair 234. I bhformáid HTML, tá níos mó clibeanna ná téacs.

Trí naisc i stíl tagartha Markdown is féidir an doiciméad a dhéanamh níos cosúla le toradh deiridh an bhrabhsálaí, rud a ligeann duit roinnt meiteashonraí a bhaineann le marcáil a bhogadh lasmuigh de théacs na míre, agus is féidir leat naisc a chur leis gan an t-alt a léamh.

强调

Úsáideann Markdown réiltíní (*) agus an bunlíne (_) mar shiombail chun focal a bhfuil líne faoi a mharcáil, is * Nó _ Tiontaítear focail timpeallaithe go <em> timpeallaithe ag lipéid, le dhá * Nó _Má tá sé fillte, déanfar é a thiontú i <strong>, E.g:

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

casfaidh sé isteach:

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

Is féidir leat cibé stíl is mian leat a úsáid, is é an t-aon teorainn ná gur féidir leat an tsiombail a úsáid chun an chlib a oscailt agus an tsiombail chun deireadh a chur leis.

Is féidir béim a chur go díreach i lár an téacs freisin:

un*frigging*believable

achmá tá do * 和 _ Má tá spás bán ar an dá thaobh, caitear leo mar ghnáthshiombailí.

Chun gnáthréiltíní nó foscéithe a chur isteach go díreach roimh an téacs agus ina dhiaidh, is féidir cúlslais a úsáid:

\*this text is surrounded by literal asterisks\*

Cód

Más mian leat píosa beag de chód inlíne a mharcáil, is féidir leat é a chumhdach i gcúl- tiúnta (`), m.sh.:

Use the `printf()` function.

Táirgeoidh:

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

Más mian leat cúlticks a chur isteach taobh istigh de rannán cód, is féidir leat an rannán cód a thosú agus a chríochnú le hiliomad cúlticks:

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

Táirgeann an chomhréir seo:

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

Is féidir leat bán a chur ag tús agus ag deireadh alt cód, ceann i ndiaidh an tús agus ceann roimh an deireadh, ionas gur féidir leat backticks a chur isteach ag tús na rannóige:

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

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

Táirgeoidh:

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

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

Laistigh den rannóg cód,& agus lúibíní uillinne都a thiontú go huathoibríoch chuig aonáin HTML, rud a fhágann go mbeidh sé éasca cód foinse HTML a chur isteach, cuirfidh Markdown an mhír seo a leanas:

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

chun:

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

Is féidir leat é seo a scríobh freisin:

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

Chun:

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

图片

Ar ndóigh, tá sé deacair comhréir "nádúrtha" a dhearadh chun íomhánna a chur isteach in fheidhmchlár téacs-amháin.

Úsáideann Markdown comhréir cosúil le comhréir naisc chun íomhánna a mharcáil, agus ceadaíonn sé dhá stíl freisin: I líne和Tagairt.

Breathnaíonn an chomhréir íomhá inlíne mar seo a leanas:

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

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

Is iad seo a leanas na sonraí:

• comhartha exclamation !
• ina dhiaidh sin beidh lúibín cearnach le téacs alt don íomhá
• Ina dhiaidh sin bíonn gnáth lúibíní le URL na híomhá, agus ar deireadh tá téacs 'teideal' roghnach iniata sna comharthaí athfhriotail.

Breathnaíonn an chomhréir íomhá tagartha mar seo:

![Alt text][id]

"id" is ainm don tagairt íomhá, a shainmhínítear ar an mbealach céanna le tagairt naisc:

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

Go dtí seo, níl aon bhealach ag Markdown leithead agus airde an íomhá a shonrú, más gá duit, is féidir leat an gnáth a úsáid <img> lipéad.

其它

nasc uathoibríoch

Tacaíonn Markdown le próiseáil URLanna agus ríomhphoist i bhfoirm naisc ghearr uathoibríocha.Chomh fada agus atá siad faoi iamh idir lúibíní uillinn, déanfaidh Markdown nasc a thiontú go huathoibríoch.Tá téacs naisc an URL ginearálta mar an gcéanna leis an seoladh naisc, mar shampla:

<http://example.com/>

Tiontófar Markdown go:

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

Tá nascadh uathoibríoch seoltaí ríomhphoist an-chosúil freisin, ach amháin go ndéanfaidh Markdown próiseas comhshó ionchódaithe ar dtús, ag aistriú carachtair téacs go heicsidheachúlach HTML. Is féidir leis an bhformáid seo droch-róbait bailithe seoltaí ríomhphoist a mhealladh, mar shampla:

<[email protected]>

Casfaidh Markdown isteach:

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

Sa bhrabhsálaí, an teaghrán seo (i ndáiríre <a href="mailto:[email protected]">[email protected]</a>) chun bheith ina nasc inchliceáilte “[email protected]”.

(Cé gur féidir leis an gcur chuige seo a lán róbait a amú, ní féidir leis stop a chur leo go léir, ach is fearr é ná rud ar bith. Ar aon chuma, tarraingeoidh oscailt do bhosca poist litreacha fógraíochta ar deireadh thiar.)

cúlslais

Is féidir le Markdown cúlslais a úsáid chun siombailí a bhfuil bríonna eile acu a chur isteach sa ghramadach, mar shampla: más mian leat réiltín a chur in aice leis an téacs le haghaidh béime (ach ní <em> tag), is féidir leat cúlslais a fháil roimh an réiltín:

\*literal asterisks\*

Tacaíonn Markdown leis na siombailí seo a leanas agus cúlslais roimhe chun cabhrú le siombailí coitianta a chur isteach:

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

Markdown eagarthóir saor in aisce,

ardán Windows

• Markdownpad
• MarkPad

ardán Mac

• bog

eagarthóir ar líne

• Eagarthóir MPXNUMX

breiseán brabhsálaí

• Markdown anseo breiseán

*** Má tá eagarthóir Markdown saor in aisce níos fearr le moladh, tabhair aird ar aiseolasChen Weiliang, go raibh maith agat!