Dè a tha an sloinneadh Markdown a 'ciallachadh? Mar a chleachdas tu co-chòrdadh Markdown / comharrachadh cruth?

MarkdownDè tha a ’ciallachadh?

Mar a chleachdas tu co-chòrdadh Markdown / comharrachadh cruth?

Sealladh farsaing

Tha Markdown na chànan comharrachaidh aotrom a chruthaich John Gruber.

Leigidh e le daoine “sgrìobhainnean a sgrìobhadh ann an cruth teacsa shìmplidh a tha furasta a leughadh agus a sgrìobhadh, agus an uairsin an tionndadh gu sgrìobhainnean dligheach XHTML (no HTML).

Tha an cànan a’ gabhail a-steach mòran de fheartan comharradh teacsa shìmplidh a chaidh a lorg mar-thà ann am post-d.

Chruthaich John Gruber an cànan Markdown ann an 2004, ann an co-obrachadh le Aaron Swartz gu ìre mhòr air a’ cho-chòrdadh.Is e adhbhar a’ chànain “cruth teacsa shìmplidh a chleachdadh a tha furasta a leughadh, furasta a sgrìobhadh, agus a thionndaidheas gu roghnach gu XHTML (no HTML) dligheach".

adhbhar

Is e amas Markdown a bhith “furasta a leughadh agus furasta a sgrìobhadh”.

leughadh, dèan e co-dhiù网络 营销, tha eòlas luchd-cleachdaidh glè chudromach.

Bu chòir gum biodh e comasach faidhle a chaidh a sgrìobhadh ann am Markdown fhoillseachadh gu dìreach ann an teacsa shìmplidh, agus cha bu chòir dha a bhith coltach gu bheil mòran tagaichean no stiùiridhean cruth ann.

Tha cuid de chruthan teacsa-gu-HTML a’ toirt buaidh air co-chòrdadh Markdown, a’ gabhail a-steach Setext, atx, Textile, reStructuredText, Grutatext, agus EtText, ach is e cruth post-d teacsa soilleir an stòr brosnachaidh as motha.

Ann an ùine ghoirid, tha co-chòrdadh Markdown uile air a dhèanamh suas de shamhlaidhean, a tha air an taghadh gu faiceallach agus tha sùil gheur air na gnìomhan aca.Mar eisimpleir: cuir rionnagan timcheall teacsa gus am bi e coltach ri *cuideam*.

Tha liostaichean ann an Markdown a’ coimhead coltach, uill, liostaichean. Tha e coltach gu bheil Blockquotes ann an Markdown a’ togail pìos teacsa, mar a chunnaic thu ann am puist-d.

Co-chòrdail ri HTML

Is e amas gràmar Markdown a bhith na chànan sgrìobhaidh airson an lìon.

Chan eil Markdown gu bhith an àite HTML, no eadhon a thighinn faisg air, chan eil ach glè bheag de dh’ eadar-dhealachaidhean co-chòrdadh ann agus chan eil e a’ freagairt ach ri fo-sheata bheag de chomharradh HTML. Cha deach Markdown a dhealbhadh gus sgrìobhainnean HTML a dhèanamh nas fhasa a sgrìobhadh.

Nam bheachd-sa, tha HTML mar-thà furasta a sgrìobhadh. Is e beachd Markdown sgrìobhainnean a dhèanamh nas fhasa a leughadh, a sgrìobhadh, agus atharrachadh aig toil. Is e cruth foillseachaidh a th’ ann an HTML, tha Markdown aSgrìobhadh-copaidhcruth sgrìobhte.Mar sin, chan eil co-chòrdadh cruth Markdown a’ còmhdach ach nas urrainn do theacsa shìmplidh.

Faodar tagaichean nach eil còmhdaichte le Markdown a sgrìobhadh ann an HTML gu dìreach san sgrìobhainnBrosnachadh Lìnleth-bhreac.Chan fheumar seo a chomharrachadh mar HTML no Markdown; dìreach cuir ris a’ chomharra gu dìreach.

Chan eil ach cuid de eileamaidean bloc HTML ri bhith air am bacadh - leithid <div>,<table>,<pre>,<p> agus tagaichean eile, feumaidh iad a bhith air an sgaradh bho raointean susbaint eile le loidhnichean bàn ro agus às deidh sin, agus chan fhaod na tagaichean fosglaidh is dùnaidh aca a bhith air an cuairteachadh le tabaichean no beàrnan. Tha an gineadair Markdown tapaidh gu leòr gun a bhith a’ cur tagaichean bloc HTML neo-riatanach ris <p> bileag.

Tha an eisimpleir mar a leanas, a’ cur clàr HTML ris an fhaidhle Markdown:

这是一个普通段落。

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

这是另一个普通段落。

Thoir an aire nach tèid co-chòrdadh cruth Markdown eadar tagaichean bloc HTML a phròiseasadh.Mar eisimpleir, ma chleachdas tu stoidhle Markdown taobh a-staigh bloc HTML*强调*cha bhi buaidh sam bith aige.

Earrann HTML (in-loidhne) tagaichean leithid <span>,<cite>,<del> Faodar a chleachdadh gu saor ann am paragrafan Markdown, liostaichean no cinn.A rèir cleachdaidhean pearsanta, faodaidh tu eadhon tagaichean HTML a chleachdadh airson cruth gun a bhith a’ cleachdadh cruth Markdown.Eisimpleir: Mas fheàrr leat HTML <a> 或 <img> tagaichean, a dh'fhaodar a chleachdadh gu dìreach às aonais an ceangal no co-chòrdadh taga ìomhaigh a thug Markdown seachad.

Eu-coltach ri tagaichean bloc HTML, tha co-chòrdadh Markdown dligheach eadar tagaichean earrann HTML.

Tionndadh fèin-ghluasadach de charactaran sònraichte

Ann am faidhlichean HTML, tha dà charactar ann a dh’ fheumas làimhseachadh sònraichte: < 和 & . < tha samhlaidhean air an cleachdadh airson tagaichean tòiseachaidh,& Bithear a’ cleachdadh suaicheantasan gus aonadan HTML a chomharrachadh, ma tha thu dìreach airson prototype nan caractaran sin a thaisbeanadh, feumaidh tu am foirm eintiteas a chleachdadh, leithid < 和 &.

& Tha caractaran gu sònraichte a’ cur dragh air sgrìobhadairean sgrìobhainnean lìn, ma tha thu a’ dol a thaidhpeadh “AT&T", feumaidh tu sgrìobhadh"AT&T".fhad ‘s a tha thu san URL & Tha caractaran air an tionndadh cuideachd.Mar eisimpleir tha thu airson ceangal gu:

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

Feumaidh tu an tionndadh URL a sgrìobhadh mar:

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

ri chur anns an taga ceangail href ann am feartan.Chan fheumar a ràdh, tha seo furasta a leigeil seachad, agus is dòcha an àireamh as motha de mhearachdan a chaidh a lorg le dearbhadh inbhean HTML.

Tha Markdown a 'toirt cothrom dhut caractaran a sgrìobhadh gu nàdarra, agus tha e a' toirt aire do na dh'fheumar a thionndadh.ma chleachdas tu & Tha caractar na phàirt de eintiteas caractar HTML, tha e air fhàgail mar a tha, air neo thèid a thionndadh gu &;.

Mar sin ma tha thu airson samhla dlighe-sgrìobhaidh a chuir a-steach don sgrìobhainn ©, faodaidh tu sgrìobhadh:

©

Fàgaidh Markdown e gun suathadh.Agus ma sgrìobhas tu:

AT&T

Tionndaidhidh Markdown e gu:

AT&T

Tha suidheachadh coltach ris cuideachd a’ tachairt ann an < notation, leis gu bheil Markdown a’ ceadachadh co-chòrdalachd HTML, ma chuireas tu < Bithear a’ cleachdadh samhlaidhean mar chrìochan airson tagaichean HTML, agus cha dèan Markdown atharrachaidhean sam bith orra, ach ma sgrìobhas tu:

4 < 5

Tionndaidhidh Markdown e gu:

4 < 5

Ach, bu chòir a thoirt fa-near, taobh a-staigh raon a’ chòd, ge bith a bheil e in-loidhne no bloc, < 和 & an dà shamhlaGu cinnteachair an tionndadh gu aonadan HTML, feart a leigeas leat còd HTML a sgrìobhadh gu furasta ann am Markdown (an taca ri HTML, far an cuir thu na h-uile < 和 & Tha iad uile air an tionndadh gu aonadan HTML, gus còd HTML a sgrìobhadh anns an fhaidhle HTML. )

bloc eileamaid

Paragrafan agus briseadh loidhne

Tha paragraf Markdown air a dhèanamh suas de aon loidhne no barrachd de theacsa an dèidh a chèile, le barrachd air aon loidhne bhàn roimhe agus air a leantainn (is e am mìneachadh air loidhne bhàn gu bheil e coltach gu bheil i falamh air a thaisbeanadh agus gu bheilear den bheachd gur e loidhne bhàn a th’ ann. eisimpleir, , ma tha beàrnan agus tabaichean a-mhàin ann an loidhne, thèid dèiligeadh ris an loidhne mar loidhne bhàn cuideachd).Cha bu chòir paragrafan àbhaisteach a bhith air an còmhdachadh le beàrnan no tabaichean.

Tha an abairt “air a dhèanamh suas de aon loidhne teacsa no barrachd ann an sreath” gu dearbh a’ ciallachadh gu bheil Markdown a’ ceadachadh loidhnichean ùra èignichte (cuir a-steach loidhnichean ùra) taobh a-staigh paragrafan, feart a tha eadar-dhealaichte bhon mhòr-chuid de chruthan teacsa-gu-HTML eile (a’ toirt a-steach Seòrsa gluasadach" Convert Line Breaks " roghainn), tionndaidh cruthan eile gach briseadh loidhne gu <br /> bileag.

Ma nì thugu dearbhA bheil thu airson a bhith an urra ri Markdown airson a chuir a-steach <br /> Airson bileagan, brùth dà àite no barrachd aig an àite cuir a-steach agus an uairsin brùth Enter.

Gu dearbh, bheir e beagan a bharrachd obrach (àiteachan a bharrachd) airson a ghineadh <br /> , ach gu sìmplidh "tha gach loidhne ùr air a thionndadh gu <br />“Chan eil an dòigh freagarrach ann am Markdown, em ann am MarkdownaiTha luachan bloc ann an stoidhle L agus liostaichean ioma-pharagraf chan e a-mhàin nas fheumaile ach cuideachd nas fhasa a leughadh nuair a thathar a’ clò-sgrìobhadh le briseadh loidhne.

Tiotal

Tha Markdown a’ toirt taic do dhà cho-chòrdadh airson cinn, coltach ri Setext agus coltach ri atx.

Is e am foirm coltach ri Settext am foirm leis a’ bhun-loidhne, a’ cleachdadh = (tiotal as àirde) agus - (cinn dara òrdugh), mar eisimpleir:

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

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

suim sam bith = 和 - faodaidh e bhith èifeachdach.

Tha am foirm coltach ri Atx a’ cur a-steach 1 gu 6 aig toiseach na loidhne # , a rèir cinn 1 gu 6, mar eisimpleir:

# 这是 H1

## 这是 H2

###### 这是 H6

Faodaidh tu cinn-cinn coltach ri atx a “dùnadh” gu roghnach, tha seo dìreach airson bòidhchead, ma tha thu a’ faireachdainn comhfhurtail san dòigh seo, faodaidh tu a chuir ris aig deireadh na loidhne #, fhad 'sa tha an loidhne a' tighinn gu crìch # Chan fheum an àireamh a bhith co-ionann ris an toiseach (tha an àireamh de charactaran nota aig toiseach na loidhne a’ dearbhadh òrdugh an tiotail):

# 这是 H1 #

## 这是 H2 ##

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

Blockquotes Blockquotes

Bithear a’ cleachdadh luachan bacaidh markdown coltach ris an fheadhainn a chleachdar ann am post-d > de luaidh.Ma tha thu fhathast eòlach air luachan ann an litrichean post-d, tha fios agad mar a chruthaicheas tu cuòt bloca ann am faidhle Markdown, a bhiodh coltach gun bris thu na loidhnichean thu fhèin, an uairsin cuir ris > :

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

Leigidh Markdown leat a bhith leisg agus cuir ris a’ chiad loidhne den pharagraf gu lèir > :

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

Faodar iomraidhean bloca a neadachadh (me: iomraidhean taobh a-staigh iomraidhean) le bhith a’ cur àireamh eadar-dhealaichte de > :

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

Faodar co-aontaran Markdown eile a chleachdadh cuideachd taobh a-staigh bhlocaichean ainmichte, a’ toirt a-steach cinn, liostaichean, blocaichean còd, msaa:

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

Faodaidh neach-deasachaidh teacsa iomchaidh sam bith luaidh air stoidhle post-d a chruthachadh gu furasta.Mar eisimpleir ann am BBEdit faodaidh tu teacsa a thaghadh agus an uairsin taghadh bhon chlàràrdachadh rangachd luaidh.

列表

Markdown 支持 有序 列表 和 无序 列表。

Bidh liostaichean neo-òrdaichte a’ cleachdadh reultan, a bharrachd air soidhnichean, no às aonais shoidhnichean mar chomharran liosta:

*   Red
*   Green
*   Blue

Co-ionann ri:

+   Red
+   Green
+   Blue

Cuideachd co-ionann ri:

-   Red
-   Green
-   Blue

Bidh liostaichean òrdaichte a’ cleachdadh àireamhan agus an uairsin ùine:

1.  Bird
2.  McHale
3.  Parish

Tha e cudromach cuimhneachadh nach eil na h-àireamhan a chleachdas tu air an taga liosta a' toirt buaidh air an toradh HTML. Is e an comharra HTML airson an liosta gu h-àrd mar thoradh air:

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

Ma tha do chomharradh liosta sgrìobhte mar:

1.  Bird
1.  McHale
1.  Parish

no eadhon:

3. Bird
1. McHale
8. Parish

Gheibh an dithis agaibh dìreach an aon toradh HTML.Is e a’ phuing, faodaidh tu na h-àireamhan liosta ann am faidhle Markdown a dhèanamh an aon rud ri toraidhean toraidh, no ma tha thu leisg, cha leig thu leas a bhith faiceallach mu cheartachd nan àireamhan idir.

Ma chleachdas tu sgrìobhadh leisg, thathas a’ moladh tòiseachadh le 1. airson a’ chiad rud, oir dh’ fhaodadh Markdown taic a thoirt don fheart tòiseachaidh de liostaichean òrdaichte san àm ri teachd.

Mar as trice bidh an taga nì liosta air a chuir air an fhìor làimh chlì, ach faodar a chuir a-steach, suas ri 3 àiteachan, agus feumaidh an taga nì a bhith air a leantainn le co-dhiù aon àite no taba.

Gus am bi an liosta a’ coimhead nas fheàrr, faodaidh tu an t-susbaint a chuir air dòigh le indent stèidhichte:

*   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 ma tha thu leisg, tha sin ceart gu leòr cuideachd:

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

Ma tha na nithean liosta air an sgaradh le loidhnichean bàn, cleachdaidh Markdown susbaint an nì nuair a bhios e a’ toirt a-mach HTML. <p> Tha bileagan air am pasgadh, mar eisimpleir:

*   Bird
*   Magic

thèid a thionndadh gu:

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

Ach seo:

*   Bird

*   Magic

thèid a thionndadh gu:

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

Faodaidh grunn pharagrafan a bhith ann an nithean liosta, agus feumaidh na paragrafan fo gach nì a bhith air an cuir a-steach le 4 beàrnan no 1 taba:

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.

Tha e a’ coimhead tòrr nas fheàrr ma chuireas tu a-steach gach loidhne, gu dearbh, a-rithist, ma tha thu leisg, leigidh Markdown cuideachd:

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

Ma tha thu airson iomradh a chuir am broinn nì liosta, an uairsin > Feumaidh e a bhith air a chòmhdach:

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

Ma tha thu airson bloc còd a chuir, feumaidh am bloca a bhith air a chuir a-steachdà uair, a tha 8 beàrnan no 2 tabaichean:

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

        <代码写在这>

Gu dearbh, dh’ fhaodadh liosta de nithean a bhith air an cruthachadh gun fhiosta, rudeigin mar seo:

1986. What a great season.

Ann am faclan eile, tha e a’ nochdadh aig toiseach na loidhneàireamh-ùine-bàn, gus seo a sheachnadh, faodaidh tu backslash a chuir ris ron ùine.

1986\. What a great season.

代码 区块

Mar as trice tha blocaichean còd air an clò-bhualadh ann an sgrìobhadh co-cheangailte ri prògram no còd stòr cànain tag. Mar as trice, chan eil sinn ag iarraidh gum bi na blocaichean sin air an clò-bhualadh mar fhaidhlichean paragraf coitcheann, ach gan taisbeanadh mar a tha iad. Cleachdaidh Markdown <pre> 和 <code> tagaichean gus blocaichean còd a chòmhdach.

Tha blocaichean còd togail ann am Markdown cho sìmplidh ri bhith a’ cuir a-steach 4 àiteachan no 1 taba, mar eisimpleir, cuir a-steach na leanas:

这是一个普通段落：

    这是一个代码区块。

Tionndaidhidh Markdown gu:

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

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

Tha an indentation ciad-òrdugh seo airson gach loidhne (4 beàrnan no 1 taba) air a thoirt air falbh, mar eisimpleir:

Here is an example of AppleScript:

    tell application "Foo"
        beep
    end tell

thèid a thionndadh gu:

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

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

Tha bloc de chòd a 'leantainn gus an loidhne neo-cheangailte (no deireadh an fhaidhle).

Taobh a-staigh bloc còd, & , < 和 > Thèid a thionndadh gu fèin-ghluasadach gu aonadan HTML. Tha an dòigh seo ga dhèanamh glè fhurasta dhut Markdown a chleachdadh gus an còd stòr HTML a chuir a-steach airson an eisimpleir, dìreach dèan lethbhreac agus pasg air, cuir indentation ris, agus làimhsichidh Markdown an còrr dhut, airson eisimpleir:

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

thèid a thionndadh gu:

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

Anns a ’bhloc còd, cha tèid an co-chòrdadh Markdown coitcheann a thionndadh, leithid rionnagan dìreach rionnagan, a tha a’ ciallachadh gun urrainn dhut faidhlichean co-cheangailte ri co-chòrdadh Markdown a sgrìobhadh gu furasta ann an co-chòrdadh Markdown.

Divider

你 可以 在 一行 中用 三个 以上 的 星 号 、 减号 、 底线 来 建立 一个 分隔线 ， 行 内 不能 有 其他 东西。 你 也 可以 每种 号 或是 建立 建立 建立 建立 建立 建立 每种 写法 可以 建立分隔线 ：

* * *

***

*****

- - -

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

eileamaid earrann

Ceangal

Tha Markdown a’ toirt taic do dhà sheòrsa de cho-chòrdadh ceangail: In-loidhne和Iomradhdà fhoirm.

Co-dhiù, tha teacsa ceangail air a chomharrachadh le [camagan ceàrnagach].

a chruthachadh aIn-loidhneMa tha thu airson teacsa tiotal a’ cheangail a chur ris, dìreach paisg an teacsa tiotal le comharran luachan dùbailte às deidh an URL, mar eisimpleir:

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

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

Bheir:

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

Ma tha thu a’ ceangal ri goireasan air an aon òstair, faodaidh tu slighean càirdeach a chleachdadh:

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

IomradhTha an ceangal air a leantainn le camagan ceàrnagach eile às deidh camagan an teacsa ceangail, agus bu chòir an comharra a chaidh a chleachdadh gus an ceangal aithneachadh a lìonadh san dàrna camag ceàrnagach:

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

Faodaidh tu cuideachd àite a chuir eadar an dà camagan ceàrnagach gu roghnach:

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

An uairsin, an àite sam bith san fhaidhle, faodaidh tu susbaint ceangail an taga seo a mhìneachadh:

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

Tha susbaint ceangail air a mhìneachadh san fhoirm:

• Camagan ceàrnagach (roghainneil suas ri trì beàrnan ro làimh airson cuir a-steach) anns an cuirear teacsa ceangail a-steach
• air a leantainn le coloin
• air a leantainn le aon àite no tabaichean no barrachd
• URL an ath cheangail
• Gu roghnach lean susbaint an tiotail, a dh’ fhaodar a chuartachadh ann an luachan singilte, luachan dùbailte, no bracaidean

Tha na mìneachaidhean air na trì ceanglaichean a leanas mar an ceudna:

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

rabhadh:Tha cùis aithnichte ann far a bheil Markdown.pl 1.0.1 a’ seachnadh tiotalan ceangail ceangailte ann an luachan singilte.

Faodar URLan ceangail a chuartachadh cuideachd eadar camagan ceàrn:

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

Faodaidh tu cuideachd am feart tiotal a chuir air an ath loidhne, no cuir a-steach beagan indentation, a choimheadas nas fheàrr ma tha an URL ro fhada:

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

Chan eil am mìneachadh URL air a chleachdadh ach nuair a thathar a’ cruthachadh a’ cheangail, agus chan eil e a’ nochdadh gu dìreach san fhaidhle.

Faodaidh litrichean, àireamhan, àite geal agus puingeachadh a bhith ann an tagaichean aithneachaidh ceangail, ach chan eilChan eilTha e mothachail air cùis, agus mar sin tha an dà cheangal a leanas mar an ceudna:

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

Tag ceangail ciallachfeart a’ leigeil leat sònrachadh taga ceangail fhàgail air falbh. Anns a’ chùis seo, thèid dèiligeadh ris an taga ceangail mar rud co-ionann ri teacsa a’ cheangail. Gus taga ceangail so-thuigsinn a chleachdadh, dìreach cuir camag ceàrnagach falamh ris às deidh an teacsa ceangail. Ma tha thu ag iarraidh "Google " A 'ceangal ri google.com, faodaidh tu a dhèanamh nas sìmplidhe gu:

[Google][]

An uairsin sònraich susbaint a ’cheangail:

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

Leis gum faodadh beàrn geal a bhith ann an teacsa ceangail, faodaidh gum bi grunn fhaclan anns a’ chomharra shìmplidh seo:

Visit [Daring Fireball][] for more information.

An uairsin lean air adhart gus an ceangal a mhìneachadh:

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

Faodar mìneachadh a’ cheangail a chuir an àite sam bith san fhaidhle.Is fheàrr leam a chuir dìreach às deidh a’ pharagraf far a bheil an ceangal a’ nochdadh Faodaidh tu cuideachd a chuir aig deireadh an fhaidhle, dìreach mar bheachd.

Seo eisimpleir de cheangal fiosrachaidh:

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"

Ma dh'atharraicheas tu e gus an t-ainm ceangail a chleachdadh airson sgrìobhadh:

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"

Bheir an dà dhòigh sgrìobhaidh gu h-àrd an HTML a leanas.

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

Gu h-ìosal tha faidhle Markdown den aon susbaint sgrìobhte air-loidhne, air a sholarachadh airson coimeas:

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

Gu dearbh, chan e puing nan ceanglaichean stoidhle iomraidh gu bheil e nas fhasa a sgrìobhadh, ach gu bheil e nas fhasa a leughadh Dèan coimeas eadar an eisimpleir gu h-àrd Chan eil anns an artaigil stoidhle iomraidh fhèin ach 81 caractar, ach àrdaichidh am foirm in-loidhne gu 176 caractar. , ma tha e sgrìobhte ann an cruth HTML fìor-ghlan, bidh 234 caractar ann. Ann an cruth HTML, tha barrachd thagaichean na teacsa.

A’ cleachdadh ceanglaichean stoidhle iomraidh Markdown, faodaidh tu an sgrìobhainn a dhèanamh nas coltaiche ri toradh deireannach a’ bhrobhsair, a’ toirt cothrom dhut meata-dàta co-cheangailte ri comharrachadh a ghluasad taobh a-muigh teacsa na paragraf, agus faodaidh tu ceanglaichean a chuir ris gun a bhith a’ toirt air leughadh an artaigil. .

Cuir cuideam air

Bidh Markdown a’ cleachdadh rionnagan (*) agus an loidhne as ìsle (_) mar shamhla airson facal le loidhne a chomharrachadh, is * 或 _ Tha faclan mun cuairt air an tionndadh gu <em> air a chuartachadh le suaicheantasan, le dhà * 或 _Ma tha e air a phasgadh, thèid a thionndadh a-steach <strong>, E.g:

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

tionndaidhidh e gu:

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

Faodaidh tu stoidhle sam bith a thogras tu a chleachdadh, is e an aon chuingealachadh gum faod thu an taga fhosgladh leis an t-samhla a tha thu airson crìoch a chuir air.

Faodar cuideam a chuir a-steach gu dìreach ann am meadhan an teacsa cuideachd:

un*frigging*believable

achma tha do * 和 _ Ma tha àite geal air gach taobh, tha iad dìreach air an làimhseachadh mar shamhlaidhean àbhaisteach.

Gus rionnagan àbhaisteach no fo-fhilleadh a chuir a-steach dìreach ro agus às deidh teacsa, faodaidh tu backslashes a chleachdadh:

\*this text is surrounded by literal asterisks\*

Còd

Ma tha thu airson pìos beag de chòd in-loidhne a chomharrachadh, faodaidh tu a phasgadh ann an backticks (`), m.e.:

Use the `printf()` function.

Bheir:

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

Ma tha thu airson backticks a chuir a-steach taobh a-staigh roinn còd, faodaidh tu an roinn còd a thòiseachadh agus a chrìochnachadh le iomadh backticks:

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

Tha an co-chòrdadh seo a’ toirt a-mach:

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

Faodaidh tu bàn a chuir aig toiseach is deireadh earrann còd, aon às deidh an toiseach agus aon ron deireadh, gus an urrainn dhut cùl-fhiosrachadh a chuir a-steach aig toiseach na h-earrainn:

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

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

Bheir:

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

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

Taobh a-staigh roinn a’ chòd,& agus camagan ceàrn都thèid a thionndadh gu fèin-ghluasadach gu aonadan HTML, a tha ga dhèanamh furasta còd stòr HTML a chuir a-steach, cuiridh Markdown am paragraf a leanas:

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

gu:

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

Faodaidh tu seo a sgrìobhadh cuideachd:

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

Airson toradh:

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

图片

Gu follaiseach, tha e duilich co-chòrdadh “nàdarra” a dhealbhadh airson ìomhaighean a chuir a-steach ann an tagradh teacsa a-mhàin.

Bidh Markdown a’ cleachdadh co-chòrdadh coltach ri ceanglaichean gus ìomhaighean a chomharrachadh, agus tha e cuideachd a’ ceadachadh dà stoidhle: In-loidhne和Iomradh.

Tha an co-chòrdadh ìomhaigh in-loidhne coltach ri:

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

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

Tha mion-fhiosrachadh mar a leanas:

• comharra clisgeadh !
• 接着 一个 方 括号 ， 里面 放上 图片 的 替代 文字
• Tha seo air a leantainn le bragan àbhaisteach le URL na h-ìomhaigh, agus mu dheireadh teacsa 'tiotal' roghnach ceangailte ann an luachan.

Tha co-chòrdadh ìomhaigh iomraidh a’ coimhead mar seo:

![Alt text][id]

Is e "id" ainm an iomradh ìomhaigh, a tha air a mhìneachadh san aon dòigh ri iomradh ceangail:

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

Gu ruige seo, chan eil dòigh aig Markdown leud agus àirde an ìomhaigh a shònrachadh, ma tha feum agad air, faodaidh tu an àbhaist a chleachdadh <img> bileag.

其它

ceangal fèin-ghluasadach

Tha Markdown a 'toirt taic do bhith a' giullachd URLan agus bogsaichean puist-d ann an cruth cheanglaichean fèin-ghluasadach an ìre mhath goirid.Cho fad 's gu bheil iad dùinte ann an camagan ceàrn, tionndaidh Markdown gu ceangal gu fèin-obrachail.Tha teacsa ceangail an URL coitcheann an aon rud ris an t-seòladh ceangail, mar eisimpleir:

<http://example.com/>

Thèid Markdown a thionndadh gu:

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

Tha ceangal fèin-ghluasadach de sheòlaidhean puist-d cuideachd coltach, ach a-mhàin gun dèan Markdown pròiseas tionndaidh còdaidh an-toiseach, ag atharrachadh caractaran teacsa gu buidhnean hexadecimal HTML. Faodaidh an cruth seo cuid de dhroch innealan-fuadain cruinneachadh seòlaidhean puist-d a mhealladh, leithid:

<[email protected]>

Tionndaidhidh Markdown gu:

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

Anns a 'bhrabhsair, tha an sreang seo (gu dearbh <a href="mailto:[email protected]">[email protected]</a>) gu bhith na cheangal “seò[email protected]” a ghabhas cliogadh.

(Ged a dh’ fhaodadh an dòigh-obrach seo mòran innealan-fuadain a mhealladh, chan urrainn dha stad a chuir orra uile, ach tha e nas fheàrr na dad. Co-dhiù, ma dh’ fhosglas tu do bhogsa puist tarraingidh sin litrichean sanasachd mu dheireadh.)

cùl-taic

Faodaidh Markdown backslashes a chleachdadh gus samhlaidhean aig a bheil brìgh eile a chuir a-steach sa ghràmar, mar eisimpleir: ma tha thu airson rionnag a chuir ri taobh an teacsa airson cuideam (ach chan eil <em> tag), faodaidh tu a dhol air thoiseach air an rionnag le cùl-taic:

\*literal asterisks\*

Markdown 支持 以下 这些 符号 前面 加上 反斜杠 来 帮助 插入 普通 的 符号 ：

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

Markdown deasaiche a saor an asgaidh

Àrd-ùrlar Windows

• MarkdownPad
• MarkPad

Àrd-ùrlar Mac

• bog

neach-deasachaidh air-loidhne

• Deasaiche MPXNUMX

plugan brabhsair

• Markdown plugan an seo

*** Ma tha neach-deasachaidh Markdown an-asgaidh nas fheàrr ri mholadh, thoir aire do fhios air aisChen Weiliang,mòran taing!