Kí ni Markdown túmọ sí? Bawo ni lati lo Markdown sintasi / siṣamisi ọna kika?

SamisiKini itumo?

Bawo ni lati lo Markdown sintasi/siṣamisi ọna kika?

Atunwo

Markdown jẹ ede isamisi iwuwo fẹẹrẹ ti a ṣẹda nipasẹ John Gruber.

O gba eniyan laaye lati "kọ awọn iwe aṣẹ ni ọna kika ọrọ ti o rọrun ti o rọrun lati ka ati kọ, ati lẹhinna yi wọn pada si awọn iwe XHTML (tabi HTML) ti o wulo".

Ede naa ṣafikun ọpọlọpọ awọn ẹya ti isamisi ọrọ lasan ti a ti rii tẹlẹ ninu imeeli.

John Gruber ṣẹda ede Markdown ni 2004, ni ifowosowopo pẹlu Aaron Swartz ni apakan nla lori girama.Idi ede naa ni lati lo “ọna kika ọrọ itele ti o rọrun lati ka, rọrun lati kọ, ti o si yipada ni yiyan si XHTML (tabi HTML) ti o wulo”.

idi

Ibi-afẹde ti Markdown ni lati jẹ “rọrun lati ka ati rọrun lati kọ”.

readability, se o lonakonaInternet Marketing, olumulo iriri jẹ pataki pupọ.

Iwe-ipamọ ti a kọ sinu Markdown yẹ ki o ni anfani lati ṣe atẹjade taara ni ọrọ itele, ati pe ko yẹ ki o han pe o ni ọpọlọpọ awọn afi tabi awọn itọsọna ọna kika.

Sintasi Markdown ni ipa nipasẹ diẹ ninu awọn ọrọ-si-HTML ti o wa tẹlẹ, pẹlu Setext, atx, Textile, reStructuredText, Grutatext, ati EtText, ṣugbọn orisun ti o tobi julọ ti awokose ni ọna kika imeeli itele.

Ni kukuru, sintasi ti Markdown jẹ gbogbo awọn aami ti o wa ninu, eyiti a ti yan ni pẹkipẹki ati pe awọn iṣẹ wọn han gbangba ni iwo kan.Fun apẹẹrẹ: fi awọn ami akiyesi yika ọrọ lati jẹ ki o dabi * tcnu *.

Awọn atokọ ni Markdown dabi, daradara, awọn atokọ. Blockquotes ni Markdown gan dabi sisọ ọrọ kan, gẹgẹ bi o ti rii ninu awọn imeeli.

Ni ibamu pẹlu HTML

Idi ti girama Markdown ni lati jẹ ede kikọ fun wẹẹbu.

Markdown ko tumọ si lati rọpo HTML, tabi paapaa wa nitosi rẹ, o ni awọn oriṣi diẹ ti sintasi ati pe o baamu si ipin kekere ti isamisi HTML. Markdown ko loyun lati jẹ ki awọn iwe HTML rọrun lati kọ.

Ni ero mi, HTML ti rọrun tẹlẹ lati kọ. Ero ti Markdown ni lati jẹ ki awọn iwe aṣẹ rọrun lati ka, kọ, ati iyipada ni ifẹ. HTML jẹ ọna kika titẹjade, Markdown jẹ aKikọ kikọkika kika.Bi iru bẹẹ, ọna kika kika Markdown nikan ni wiwa ohun ti ọrọ itele le.

Awọn afi ti ko ni aabo nipasẹ Markdown le kọ ni HTML taara ninu iwe-ipamọ naaIgbega wẹẹbudaakọ.Ko si iwulo lati samisi eyi bi HTML tabi Markdown; kan ṣafikun isamisi taara.

Nikan diẹ ninu awọn eroja Àkọsílẹ HTML lati wa ni rọ - gẹgẹbi <div>,<table>,<pre>,<p> ati awọn aami afi miiran, wọn gbọdọ yapa lati awọn agbegbe akoonu miiran pẹlu awọn laini ofo ṣaaju ati lẹhin, ati ṣiṣi wọn ati awọn afi titipa ko gbọdọ jẹ indented pẹlu awọn taabu tabi awọn aaye. Olupilẹṣẹ Markdown jẹ ọlọgbọn to lati ma ṣe ṣafikun awọn ami idina HTML ti ko wulo <p> Aami.

Apẹẹrẹ jẹ bi atẹle, fifi tabili HTML kun si faili Markdown:

这是一个普通段落。

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

这是另一个普通段落。

Ṣe akiyesi pe Sintasi ọna kika Markdown laarin awọn afi idinamọ HTML kii yoo ni ilọsiwaju.Fun apẹẹrẹ, ti o ba lo ara Markdown kan ninu bulọki HTML kan*强调*yoo ni ipa kankan.

HTML apakan (inline) afi bi <span>,<cite>,<del> Le ṣee lo larọwọto ni awọn paragira Markdown, awọn atokọ tabi awọn akọle.Gẹgẹbi awọn iṣesi ti ara ẹni, o le paapaa lo awọn afi HTML si ọna kika laisi lilo ọna kika Markdown.Apeere: Ti o ba fẹ HTML <a> Tabi <img> afi, eyiti o le ṣee lo taara laisi ọna asopọ tabi sintasi tag aworan ti a pese nipasẹ Markdown.

Ko laarin awọn aami idinamọ HTML, Syntax Markdown wulo laarin awọn afi apakan HTML.

Iyipada aifọwọyi ti awọn ohun kikọ pataki

Ninu awọn faili HTML, awọn ohun kikọ meji wa ti o nilo mimu pataki: < 和 & , < Awọn aami ni a lo fun awọn aami ibẹrẹ,& Awọn aami ni a lo lati samisi awọn nkan HTML, ti o ba kan fẹ ṣafihan apẹrẹ ti awọn ohun kikọ wọnyi, o ni lati lo fọọmu nkan, bii < 和 &,

& Awọn ohun kikọ jẹ paapaa idaloro fun awọn onkọwe iwe wẹẹbu, ti o ba fẹ tẹ "AT&T", o gbọdọ kọ"AT&T".nigba ti URL & Awọn ohun kikọ tun wa ni iyipada.Fun apẹẹrẹ o fẹ lati sopọ si:

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

O ni lati kọ iyipada URL bi:

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

lati wa ni gbe ninu awọn ọna asopọ tag href ninu awọn ohun-ini.Tialesealaini lati sọ, eyi rọrun lati foju, ati boya nọmba ti o tobi julọ ti awọn aṣiṣe ti a rii nipasẹ afọwọsi awọn ajohunše HTML.

Markdown gba ọ laaye lati kọ awọn kikọ nipa ti ara, ati pe o tọju ohun ti o nilo lati yipada.ti o ba lo & Ohun kikọ jẹ apakan ti ohun kikọ HTML kan, o fi silẹ bi o ṣe jẹ, bibẹẹkọ o ti yipada si &;.

Nitorina ti o ba fẹ fi aami aṣẹ-lori sii ninu iwe-ipamọ naa ©, o le kọ:

©

Markdown yoo fi silẹ laifọwọkan.Ati pe ti o ba kọ:

AT&T

Markdown yoo yi pada si:

AT&T

A iru ipo tun waye ninu < amiakosile, niwon Markdown faye gba HTML ibamu, ti o ba ti o ba fi < Awọn aami ni a lo bi awọn ipinnu fun awọn aami HTML, ati Markdown kii yoo ṣe awọn iyipada eyikeyi lori wọn, ṣugbọn ti o ba kọ:

4 < 5

Markdown yoo yi pada si:

4 < 5

Sibẹsibẹ, o yẹ ki o ṣe akiyesi pe laarin ipari ti koodu, boya o jẹ inline tabi dina, < 和 & mejeeji aamio dajuti yipada si awọn nkan HTML, ẹya ti o fun ọ laaye lati kọ koodu HTML ni irọrun ni Markdown (ni idakeji si HTML, nibiti o ti fi gbogbo awọn < 和 & Gbogbo wọn ni iyipada si awọn nkan HTML, lati le kọ koodu HTML ninu faili HTML. )

block ano

Ìpínrọ ati laini fi opin si

Ìpínrọ̀ Markdown kan ní ọ̀kan tàbí jù bẹ́ẹ̀ lọ àwọn ìlà ọ̀rọ̀ títẹ̀léra, ṣáájú àti tẹ̀lélẹ̀ pẹ̀lú laini òfo ju ẹyọ kan lọ (itumọ̀ ti laini òfo ni pé ó dàbí ẹni pé ó ṣófo lórí ìfihàn àti pé a kà sí òfo lásán. Fún àpẹrẹ, , ti ila kan ba ni awọn aaye ati awọn taabu nikan, ila naa yoo tun ṣe itọju bi laini ofo).Awọn ìpínrọ deede ko yẹ ki o ṣe indented pẹlu awọn alafo tabi awọn taabu.

Gbolohun naa “ni ọkan tabi diẹ sii awọn laini itẹlera ti ọrọ” tumọ si gangan pe Markdown ngbanilaaye awọn laini fi agbara mu (fi sii awọn laini tuntun) laarin awọn paragira, ẹya ti o yatọ si pupọ julọ awọn ọna kika-si-HTML miiran (pẹlu Iṣipopopo Iru “Iyipada Laini Breaks). "aṣayan), awọn ọna kika miiran yoo ṣe iyipada fifọ laini kọọkan si <br /> Aami.

Ti o banitootọFẹ lati gbekele Markdown lati fi sii <br /> Fun awọn aami, tẹ meji tabi diẹ ẹ sii awọn alafo ni ibi ifibọ ati lẹhinna tẹ Tẹ.

Nitootọ, o gba iṣẹ diẹ sii (awọn aaye afikun) lati ṣe ipilẹṣẹ <br /> , sugbon nìkan "kọọkan titun ila ti wa ni iyipada si <br />Ọna naa ko dara ni Markdown, em ni MarkdownaiAwọn ọrọ idinaduro ara L-ara ati awọn atokọ ipin-ọpọlọpọ kii ṣe iwulo diẹ sii nikan ṣugbọn o rọrun lati ka nigba kikọ pẹlu awọn fifọ laini.

Akọle

Markdown ṣe atilẹyin awọn ọna ṣiṣe meji fun awọn akọle, Setext-like ati atx-like.

Fọọmu ti o dabi Settext jẹ fọọmu pẹlu laini isalẹ, lilo = (ti o ga akọle) ati - (Awọn akọle aṣẹ keji), fun apẹẹrẹ:

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

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

eyikeyi iye = 和 - le jẹ doko.

Fọọmu ti o dabi Atx fi sii 1 si 6 ni ibẹrẹ ila # , bamu si awọn akọle 1 si 6, fun apẹẹrẹ:

# 这是 H1

## 这是 H2

###### 这是 H6

O le ni yiyan “sunmọ” awọn akọle bi atx, eyi jẹ odasaka fun aesthetics, ti o ba ni itunu ni ọna yii, o le ṣafikun ni ipari laini naa. #, nigba ti ila ba pari # Nọmba naa ko ni lati jẹ kanna bi ibẹrẹ (nọmba awọn ohun kikọ iwon ni ibẹrẹ laini pinnu aṣẹ ti akọle):

# 这是 H1 #

## 这是 H2 ##

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

Blockquotes Blockquotes

Awọn ọrọ-ọna isamisi isamisi jẹ lilo iru awọn ti a lo ninu imeeli > ti awọn itọkasi.Ti o ba faramọ awọn agbasọ ọrọ ninu awọn lẹta imeeli, o mọ bi o ṣe le ṣẹda agbasọ ọrọ Àkọsílẹ ninu faili Markdown kan, eyiti yoo dabi pe o fọ awọn laini funrararẹ, lẹhinna ṣafikun > :

> 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 tun gba ọ laaye lati jẹ ọlẹ ati ṣafikun nikan laini akọkọ ti gbogbo paragira naa > :

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

Awọn itọkasi idina le jẹ itẹ-ẹiyẹ (fun apẹẹrẹ: awọn itọkasi laarin awọn itọkasi) nipa fifi nọmba ti o yatọ kun ti > :

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

Awọn ọna ṣiṣe Markdown miiran tun le ṣee lo laarin awọn bulọọki ti a sọ, pẹlu awọn akọle, awọn atokọ, awọn bulọọki koodu, ati bẹbẹ lọ:

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

Eyikeyi olootu ọrọ to tọ le ṣẹda awọn itọka ara imeeli ni irọrun.Fun apẹẹrẹ ni BBEdit o le yan ọrọ ati lẹhinna yan lati inu akojọ aṣayanpọ logalomomoise,

Awọn ile-itọju

Markdown ṣe atilẹyin awọn akojọ ti a ti paṣẹ ati ti a ko paṣẹ.

Awọn atokọ ti a ko paṣẹ lo awọn ami akiyesi, pẹlu awọn ami, tabi awọn ami iyokuro gẹgẹbi awọn ami atokọ:

*   Red
*   Green
*   Blue

Dogba si:

+   Red
+   Green
+   Blue

Tun dọgba si:

-   Red
-   Green
-   Blue

Awọn atokọ ti a paṣẹ lo awọn nọmba ti o tẹle pẹlu akoko kan:

1.  Bird
2.  McHale
3.  Parish

O ṣe pataki lati ṣe akiyesi pe awọn nọmba ti o lo lori aami atokọ ko ni ipa lori HTML ti o njade.

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

Ti isamisi atokọ rẹ ba ti kọ bi:

1.  Bird
1.  McHale
1.  Parish

tabi paapaa:

3. Bird
1. McHale
8. Parish

Iwọ mejeeji yoo gba abajade HTML kanna ni deede.Koko-ọrọ naa ni, o le ṣe awọn nọmba atokọ ni faili Markdown kanna bi awọn abajade abajade, tabi ti o ba jẹ ọlẹ, iwọ ko nilo lati bikita nipa deede awọn nọmba naa rara.

Ti o ba lo kikọ ọlẹ, o niyanju lati bẹrẹ pẹlu 1. fun ohun akọkọ, nitori Markdown le ṣe atilẹyin ẹya ibẹrẹ ti awọn atokọ ti a paṣẹ ni ọjọ iwaju.

Aami ohun akojọ ni a maa n gbe si apa osi, ṣugbọn o le ṣe indented, to awọn aaye 3, ati pe aami ohun kan gbọdọ tẹle pẹlu o kere ju aaye kan tabi taabu.

Lati jẹ ki atokọ naa dara julọ, o le ṣeto awọn akoonu pẹlu indent ti o wa titi:

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

Ṣugbọn ti o ba jẹ ọlẹ, iyẹn dara paapaa:

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

Ti awọn ohun akojọ ba yapa nipasẹ awọn laini ofo, Markdown yoo lo akoonu ohun kan nigbati o ba njade HTML. <p> Awọn aami ti wa ni ipari, fun apẹẹrẹ:

*   Bird
*   Magic

yoo yipada si:

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

Ṣugbọn eyi:

*   Bird

*   Magic

yoo yipada si:

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

Awọn nkan atokọ le ni awọn paragi pupọ ninu, ati awọn paragira labẹ ohun kọọkan gbọdọ jẹ indented nipasẹ awọn aaye 4 tabi taabu 1:

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.

O dara pupọ julọ ti o ba tẹ laini kọọkan, nitorinaa, lẹẹkansi, ti o ba jẹ ọlẹ, Markdown tun gba laaye:

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

Ti o ba fẹ fi itọkasi sinu nkan atokọ, lẹhinna > O nilo lati wa ni indented:

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

Ti o ba fẹ fi bulọọki koodu kan, bulọki naa nilo lati fi siilemeji, eyiti o jẹ awọn aaye 8 tabi awọn taabu 2:

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

        <代码写在这>

Nitoribẹẹ, atokọ awọn nkan le jẹ ipilẹṣẹ lairotẹlẹ, nkan bii eyi:

1986. What a great season.

Ni awọn ọrọ miiran, o han ni ibẹrẹ ilanọmba-akoko-òfo, Lati yago fun eyi, o le ṣafikun ẹhin ẹhin ṣaaju akoko naa.

1986\. What a great season.

koodu Àkọsílẹ

Kikọ ti o jọmọ eto tabi koodu orisun ede nigbagbogbo ni awọn bulọọki koodu typeet tẹlẹ. Nigbagbogbo, a ko fẹ ki awọn bulọọki wọnyi jẹ oriṣi ni ọna ti awọn faili paragira gbogbogbo, ṣugbọn ṣafihan wọn bi wọn ti ri. Markdown yoo lo. <pre> 和 <code> afi lati fi ipari si awọn bulọọki koodu.

Awọn bulọọki ti koodu ni Markdown jẹ bi o rọrun bi itọlẹ awọn aaye 4 tabi taabu 1, fun apẹẹrẹ, tẹ atẹle naa:

这是一个普通段落：

    这是一个代码区块。

Markdown yoo yipada si:

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

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

Ibẹrẹ aṣẹ-akọkọ yii fun laini (awọn aaye 4 tabi taabu 1) ti yọkuro, fun apẹẹrẹ:

Here is an example of AppleScript:

    tell application "Foo"
        beep
    end tell

yoo yipada si:

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

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

Bulọọki koodu kan tẹsiwaju titi laini ti a ko fi silẹ (tabi opin faili naa).

Ninu koodu idinamọ, & , < 和 > Yoo yipada laifọwọyi si awọn ẹya HTML. Ọna yii jẹ ki o rọrun pupọ fun ọ lati lo Markdown lati fi koodu orisun HTML sii fun apẹẹrẹ, kan daakọ ati lẹẹmọ rẹ, ṣafikun indentation, ati pe Markdown iyokù yoo mu fun ọ, fun apẹẹrẹ:

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

yoo yipada si:

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

Ninu koodu koodu, sintasi Markdown gbogbogbo kii yoo yipada, gẹgẹbi awọn ami akiyesi jẹ awọn ami akiyesi nikan, eyiti o tumọ si pe o le ni rọọrun kọ awọn faili ti o ni ibatan sintasi Markdown ni sintasi Markdown.

onipinpin

O le ṣẹda olupin kan pẹlu diẹ ẹ sii ju awọn aami akiyesi mẹta, awọn ami iyokuro, awọn ami-ami ni ila, ko si ohun miiran ninu laini.O tun le fi awọn alafo sii laarin awọn ami akiyesi tabi iyokuro.Awọn laini iyapa le ṣẹda ni ọkọọkan awọn ọna kikọ atẹle wọnyi:

* * *

***

*****

- - -

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

apakan ano

ọna asopọ

Markdown ṣe atilẹyin awọn ọna asopọ ọna asopọ meji: Ni tito和Itọkasimeji fọọmu.

Ọna boya, ọrọ ọna asopọ ti samisi pẹlu [awọn biraketi onigun mẹrin].

lati ṣẹda aNi titoTi o ba fẹ ṣafikun ọrọ akọle ti ọna asopọ, kan fi ipari si ọrọ akọle pẹlu awọn ami asọye ilọpo meji lẹhin URL, fun apẹẹrẹ:

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

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

Yoo ṣe:

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

Ti o ba n sopọ si awọn orisun lori agbalejo kanna, o le lo awọn ọna ibatan:

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

ItọkasiỌna asopọ naa ni atẹle nipasẹ akọmọ onigun mẹrin miiran lẹhin akọmọ ti ọrọ ọna asopọ, ati ami ti a lo lati ṣe idanimọ ọna asopọ yẹ ki o kun ni akọmọ onigun mẹrin keji:

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

O tun le ni yiyan fi aaye si laarin awọn biraketi onigun meji:

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

Lẹhinna, nibikibi ninu faili naa, o le ṣalaye akoonu ọna asopọ ti tag yii:

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

Akoonu ọna asopọ jẹ asọye ni fọọmu:

• Awọn biraketi onigun mẹrin (aṣayan ṣaju nipasẹ awọn aye to awọn aaye mẹta fun itọsi) ninu eyiti ọrọ ọna asopọ ti wa ni titẹ sii
• atẹle nipa a oluṣafihan
• atẹle nipa ọkan tabi diẹ ẹ sii awọn alafo tabi awọn taabu
• URL ti ọna asopọ atẹle
• Ni yiyan tẹle akoonu akọle, eyiti o le wa ni paade ni awọn agbasọ ẹyọkan, awọn agbasọ ilọpo meji, tabi awọn akọmọ

Awọn itumọ ti awọn ọna asopọ mẹta wọnyi jẹ kanna:

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

iṣọra:Ọrọ kan ti a mọ nibiti Markdown.pl 1.0.1 foju kọju si awọn akọle ọna asopọ ti o wa ninu awọn agbasọ ẹyọkan.

Awọn URL ọna asopọ tun le paamọ ni awọn biraketi igun:

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

O tun le fi ẹda akọle sori laini atẹle, tabi ṣafikun diẹ ninu indentation, eyiti yoo dara dara julọ ti URL ba gun ju:

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

Itumọ URL nikan ni a lo nigbati o ba ṣẹda ọna asopọ, ko si han taara ninu faili naa.

Awọn afi idanimọ ọna asopọ le ni awọn lẹta ninu, awọn nọmba, aaye funfun, ati aami ifamisi, ṣugbọn kii ṣeKii ṣeO jẹ ifarabalẹ ọran, nitorinaa awọn ọna asopọ meji atẹle jẹ kanna:

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

Aami ọna asopọ ti ko tọẸya ara ẹrọ ngbanilaaye lati yọkuro pato aami ọna asopọ kan. Ni idi eyi, aami ọna asopọ yoo jẹ deede si ọrọ ọna asopọ. Lati lo aami ọna asopọ ti ko tọ, kan ṣafikun akọmọ onigun mẹrin ṣofo lẹhin ọrọ ọna asopọ. Ti o ba fẹ “Google "Nsopọ si google.com, o le rọrun si:

[Google][]

Lẹhinna ṣalaye akoonu ọna asopọ:

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

Niwọn igba ti ọrọ ọna asopọ le ni aaye funfun ninu, isamisi irọrun yii le ni awọn ọrọ lọpọlọpọ ninu:

Visit [Daring Fireball][] for more information.

Lẹhinna tẹsiwaju lati ṣalaye ọna asopọ naa:

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

Itumọ ọna asopọ le wa ni ibikibi ninu faili naa Mo fẹ lati fi sii taara lẹhin paragira nibiti ọna asopọ yoo han, o tun le fi sii ni ipari faili naa, gẹgẹ bi asọye.

Eyi ni apẹẹrẹ ọna asopọ itọkasi kan:

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"

Ti o ba yipada lati lo orukọ ọna asopọ lati kọ:

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"

Awọn ọna kikọ meji ti o wa loke yoo ṣe agbejade HTML wọnyi.

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

Ni isalẹ ni faili Markdown ti akoonu kanna ti a kọ laini, ti a pese fun lafiwe:

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

Ni otitọ, aaye ti awọn ọna asopọ ọna itọkasi kii ṣe pe o rọrun lati kọ, ṣugbọn pe o rọrun lati ka. Awọn ohun kikọ 81., Ti a ba kọ ọ ni ọna kika HTML mimọ, awọn ohun kikọ yoo wa 176. Ni ọna kika HTML, awọn afi sii ju ọrọ lọ.

Lilo awọn ọna asopọ ara-itọkasi ti Markdown, o le jẹ ki iwe-ipamọ diẹ sii bii abajade ikẹhin ti ẹrọ aṣawakiri, gbigba ọ laaye lati gbe diẹ ninu awọn metadata ti o ni ibatan si isamisi ita ọrọ paragira, ati pe o le ṣafikun awọn ọna asopọ laisi ṣiṣe rilara kika ti nkan naa. .

rinlẹ

Markdown nlo awọn ami akiyesi (*) ati laini isalẹ (_) gẹgẹbi aami lati samisi ọrọ ti o wa ni abẹlẹ, jẹ * Tabi _ Awọn ọrọ ti o yika ti yipada si <em> ti yika nipasẹ aami, pẹlu meji * Tabi _Ti o ba ti wa ni ti a we, o yoo wa ni iyipada sinu <strong>, Fun apẹẹrẹ:

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

yoo yipada si:

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

O le lo eyikeyi ara ti o fẹ, opin nikan ni pe o le ṣii tag pẹlu aami ti o fẹ lati pari pẹlu.

Itẹnumọ tun le fi sii taara ni aarin ọrọ:

un*frigging*believable

ṣugbọnti o ba ti rẹ * 和 _ Ti aaye funfun ba wa ni ẹgbẹ mejeeji, wọn kan ṣe itọju bi awọn aami deede,

Lati fi awọn ami akiyesi deede sii tabi ṣoki taara ṣaaju ati lẹhin ọrọ, o le lo awọn ifẹhinti:

\*this text is surrounded by literal asterisks\*

Koodu

Ti o ba fẹ samisi nkan kekere ti koodu inline, o le fi ipari si ni awọn ẹhin ẹhin (`), Fun apẹẹrẹ:

Use the `printf()` function.

Yoo ṣe:

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

Ti o ba fẹ fi awọn ifẹhinti sii inu apakan koodu kan, o le bẹrẹ ati pari apakan koodu pẹlu awọn ẹhin ọpọ:

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

Sintasi yii gbejade:

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

O le fi òfo kan si ibẹrẹ ati ipari apakan koodu kan, ọkan lẹhin ibẹrẹ ati ọkan ṣaaju ipari, nitorinaa o le fi awọn ẹhin ẹhin sii ni ibẹrẹ apakan:

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

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

Yoo ṣe:

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

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

Ninu apakan koodu,& ati igun biraketi都yoo yipada laifọwọyi si awọn nkan HTML, eyiti o jẹ ki o rọrun lati fi koodu orisun HTML sii, Markdown yoo fi paragira atẹle yii:

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

si:

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

O tun le kọ eyi:

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

Lati gbejade:

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

图片

O han ni, o nira lati ṣe apẹrẹ sintasi “adayeba” fun fifi awọn aworan sii ni ohun elo-ọrọ nikan.

Markdown nlo sintasi kan ti o jọra si awọn ọna asopọ lati samisi awọn aworan, ati tun gba awọn aza meji laaye: Ni tito和Itọkasi,

Sintasi aworan inline dabi:

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

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

Awọn alaye jẹ bi atẹle:

• ohun exclamation ami !
• atẹle nipa akọmọ onigun mẹrin pẹlu ọrọ alt fun aworan naa
• Eyi ni atẹle nipasẹ awọn akọmọ deede pẹlu URL ti aworan naa, ati nikẹhin ọrọ ‘akọle’ iyan ti a fi sinu awọn agbasọ ọrọ.

Sintasi aworan itọkasi dabi eyi:

![Alt text][id]

"id" ni orukọ itọkasi aworan, eyiti o jẹ asọye ni ọna kanna gẹgẹbi itọkasi ọna asopọ:

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

Nitorinaa, Markdown ko ni ọna lati pato iwọn ati giga ti aworan naa, ti o ba nilo, o le lo deede. <img> Aami.

其它

auto ọna asopọ

Markdown ṣe atilẹyin ṣiṣe awọn URL ati awọn apoti ifiweranṣẹ imeeli ni irisi awọn ọna asopọ adaṣe kukuru kukuru. Niwọn igba ti wọn ba wa ni paade ni awọn biraketi igun, Markdown yoo yipada laifọwọyi sinu ọna asopọ kan.Ọrọ ọna asopọ ti URL gbogbogbo jẹ kanna bi adirẹsi ọna asopọ, fun apẹẹrẹ:

<http://example.com/>

Markdown yoo yipada si:

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

Isopọpọ aifọwọyi ti awọn adirẹsi imeeli tun jọra pupọ, ayafi ti Markdown yoo kọkọ ṣe ilana iyipada koodu, yiyipada awọn kikọ ọrọ sinu awọn nkan HTML hexadecimal. Ọna kika yii le tan diẹ ninu awọn roboti gbigba adirẹsi imeeli buburu, gẹgẹbi:

<[email protected]>

Markdown yoo yipada si:

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

Ninu ẹrọ aṣawakiri, okun yii (gangan <a href="mailto:[email protected]">[email protected]</a>) di ọna asopọ "[email protected]" ti o tẹ.

(Biotilẹjẹpe ọna yii le tan ọpọlọpọ awọn roboti, ko le da gbogbo wọn duro, ṣugbọn o dara ju ohunkohun lọ. Ni eyikeyi idiyele, ṣiṣi apoti ifiweranṣẹ rẹ yoo fa awọn lẹta ipolongo nikẹhin.)

ifẹhinti

Markdown le lo awọn ifẹhinti lati fi awọn aami sii ti o ni awọn itumọ miiran ninu girama, fun apẹẹrẹ: ti o ba fẹ fi aami akiyesi kan kun lẹgbẹẹ ọrọ fun tcnu (ṣugbọn kii ṣe <em> tag), o le ṣaju aami akiyesi pẹlu ifẹhinti:

\*literal asterisks\*

Markdown ṣe atilẹyin awọn aami atẹle ti o ṣaju nipasẹ ifẹhinti lati ṣe iranlọwọ lati fi awọn aami ti o wọpọ sii:

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

Markdown free olootu

Windows Syeed

• MarkdownPad
• MarkPad

Mac Syeed

• Rirọ

online olootu

• MPEditor

kiri itanna

• Markdown nibi itanna

*** Ti o ba jẹ olootu Markdown ọfẹ ti o dara julọ lati ṣeduro, jọwọ fiyesi si esiChen Weiliang,o ṣeun!