Directory artaigil
Dè tha Markdown 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”.
Tha so-leughaidh deatamach; ge bith ciamar a bhios tu a’ dèanamh margaidheachd air-loidhne , tha eòlas an neach-cleachdaidh air leth cudromach.
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 gu math furasta a sgrìobhadh mu thràth. Is e feallsanachd Markdown sgrìobhainnean a dhèanamh nas fhasa a leughadh, a sgrìobhadh agus atharrachadh. Is e cruth foillseachaidh a th’ ann an HTML, agus is e cruth sgrìobhaidh sgrìobhainnean a th’ ann am Markdown . Mar sin, chan eil co-chòrdadh Markdown a’ còmhdach ach an raon as urrainn teacsa lom a ghabhail a-steach.
Faodar tagaichean nach eil còmhdaichte le Markdown a chleachdadh gu dìreach anns an sgrìobhainn HTML agad gus an lethbhreac sanasachd air-loidhne agad a sgrìobhadh . Chan fheum thu a ràdh gu soilleir a bheil e HTML no Markdown; dìreach cuir na tagaichean ris 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 deasaiche teacsa sam bith deagh luachan ann an stoidhle post-d a chruthachadh gu furasta. Mar eisimpleir, ann am BBEdit, faodaidh tu an teacsa a thaghadh agus an uairsin ìre luachan a chur ris bhon chlàr-taice.
列表
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 chur a-steach, feumar am bloc sin a dhèanamh dà uair nas tarraingiche , is e sin 8 àiteachan no 2 taba:
* 一列表项包含一个列表区块：
<代码写在这>
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, gus an suidheachadh a sheachnadh far a bheil àite-puing-àireamh a’ nochdadh aig toiseach loidhne , faodaidh tu loidhne-sleamhainn a chur ron phuing.
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">
© 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àradh ceangail: inline agus reference.
Co-dhiù, tha teacsa ceangail air a chomharrachadh le [camagan ceàrnagach].
Gus ceangal in-loidhne a chruthachadh , dìreach lean na camagan ceàrnagach le camagan agus cuir a-steach an URL. Ma tha thu airson teacsa tiotal a chur ris a’ cheangal cuideachd, dìreach cuir teacsa an tiotail ann an luachan dùbailte às dèidh 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.
Cruthaichear ceanglaichean ann an stoidhle fiosrachaidh le bhith a’ cur teacsa a’ cheangail ann am bragan, agus an uair sin seata eile de chamagan ceàrnagach. Taobh a-staigh an dàrna seata seo de chamagan, bu chòir comharra a chur gus an ceangal aithneachadh:
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)
Thoir an aire: Tha duilgheadas aithnichte ann leis gu bheil Markdown.pl 1.0.1 a’ seachnadh tiotalan cheanglaichean 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, àiteachan agus comharran puingeachaidh a bhith ann an comharran-aithneachaidh cheanglaichean, ach chan eil iad mothachail air cùis; mar sin, tha an dà cheangal a leanas co-ionann:
[link text][a]
[link text][A]
Leigidh tagaichean ceangail neo-shoilleir leat gun a bhith a’ sònrachadh tag ceangail. Anns a’ chùis seo, thathar a’ làimhseachadh an tag ceangail mar gum biodh e co-ionann ris an teacsa ceangail. Gus tagaichean ceangail neo-shoilleir a chleachdadh, dìreach cuir camagan ceàrnagach falamh às dèidh teacsa a’ cheangail. Ma tha thu airson gum bi “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>—</code> is the decimal-encoded
equivalent of <code>—</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àradh coltach ri co-chàradh cheanglaichean gus ìomhaighean a chomharrachadh, agus leigidh e le dà stoidhle cuideachd: inline agus reference.
Tha an co-chòrdadh ìomhaigh in-loidhne coltach ri:
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
Àrd-ùrlar Mac
neach-deasachaidh air-loidhne
plugan brabhsair
*** Ma tha molaidhean nas fheàrr agaibh airson luchd-deasachaidh Markdown an-asgaidh, na bi leisg innse do Chen Weiliang . Tapadh leibh!
Tha mi an dòchas gum bi an t-artaigil “What is Markdown? How to use Markdown syntax/formatting tags?” a chaidh a cho-roinn air blog Chen Weiliang ( https://www.chenweiliang.com/ ) feumail dhut.
Faodaidh sibh ceangal an artaigil seo a cho-roinn: https://www.chenweiliang.com/cwl-482.html