He aha ka manaʻo o Markdown? Pehea e hoʻohana ai i ka Markdown syntax/formatting markup?

MarkdownHe aha ke ʻano?

Pehea e hoʻohana ai i ka Markdown syntax/formatting markup?

概况

ʻO Markdown kahi ʻōlelo markup māmā i hana ʻia e John Gruber.

Hiki i ka poʻe ke "kākau i nā palapala ma kahi ʻano kikokikona maʻalahi e heluhelu a kākau, a laila hoʻohuli iā lākou i mau palapala XHTML (a i ʻole HTML) kūpono".

Hoʻokomo ʻia ka ʻōlelo i nā hiʻohiʻona o ka hōʻailona kikokikona maʻemaʻe i ʻike mua ʻia ma ka leka uila.

Ua hana ʻo John Gruber i ka ʻōlelo Markdown i ka makahiki 2004, me ka hui pū ʻana me Aaron Swartz i ka hapa nui ma ka syntax.ʻO ke kumu o ka ʻōlelo ʻo ia ka hoʻohana ʻana i "kahi ʻano kikokikona maʻalahi e heluhelu, maʻalahi e kākau, a me ka hoʻololi ʻana i ka XHTML kūpono (a i ʻole HTML)".

kumu

ʻO ka pahuhopu o Markdown ka "maʻalahi e heluhelu a maʻalahi e kākau".

hiki ke heluhelu, e hana naeHoʻolaha Pūnaewele, mea nui ka ʻike mea hoʻohana.

Pono e paʻi pololei ʻia kahi palapala i kākau ʻia ma Markdown ma ka kikokikona maʻamau, a ʻaʻole pono e haku ʻia me nā hōʻailona he nui a i ʻole nā ​​kuhikuhi hōʻano.

Hoʻopili ʻia ka syntax Markdown e kekahi mau kikokikona-to-HTML format, me Setext, atx, Textile, reStructuredText, Grutatext, a me EtText, akā ʻo ke kumu nui o ka hoʻoulu ʻana ʻo ia ka palapala leka uila maʻalahi.

I ka pōkole, ʻo ka syntax o Markdown ka mea i haku ʻia me nā hōʻailona, ​​​​i koho pono ʻia a maopopo kā lākou mau hana i ka nānā ʻana.No ka laʻana: e kau i nā asterisk a puni ka kikokikona i mea e like ai ke ʻano o *koikoʻi*.

ʻO nā papa inoa ma Markdown e like me nā papa inoa. ʻO nā blockquotes ma Markdown e like me ka ʻōlelo ʻana i kahi ʻāpana kikokikona, e like me kāu i ʻike ai ma nā leka uila.

Kūpono me HTML

ʻO ka pahuhopu o ka Markdown grammar he ʻōlelo kākau no ka pūnaewele.

ʻAʻole manaʻo ʻia ʻo Markdown e pani i ka HTML, a i ʻole e hoʻokokoke aku iā ia, he liʻiliʻi loa nā ʻano syntax a pili i kahi ʻāpana liʻiliʻi o HTML markup. ʻAʻole i manaʻo ʻia ʻo Markdown e maʻalahi i nā palapala HTML e kākau.

I koʻu manaʻo, ua maʻalahi ka HTML e kākau. ʻO ka manaʻo o Markdown e maʻalahi i nā palapala e heluhelu, kākau, a hoʻololi i ka makemake. He palapala hoʻopuka HTML, ʻo Markdown kahiKope kopepalapala palapala.No laila, uhi wale ka syntax formatting a Markdown i ka mea hiki ke kikokiko.

Hiki ke kākau pololei ʻia nā huaʻōlelo i uhi ʻole ʻia e Markdown ma HTML i ka palapalaHoʻolaha pūnaewelekope.ʻAʻohe pono e kaha i kēia me HTML a i ʻole Markdown; e hoʻohui pololei i ka markup.

ʻO kekahi mau mea poloka HTML wale nō e kāohi ʻia - e like me <div>,<table>,<pre>,<p> a me nā hōʻailona ʻē aʻe, pono lākou e hoʻokaʻawale ʻia mai nā wahi maʻiʻo ʻē aʻe me nā laina hakahaka ma mua a ma hope, a ʻaʻole hiki ke hoʻopili ʻia kā lākou mau hōʻailona wehe a pani ʻia me nā tab a i ʻole nā ​​​​wāwae. Maikaʻi ka mīkini hana Markdown ʻaʻole e hoʻohui i nā hōʻailona poloka HTML pono ʻole <p> lepili

Penei ka laʻana, e hoʻohui ana i kahi papa HTML i ka faila Markdown:

这是一个普通段落。

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

这是另一个普通段落。

E hoʻomaopopo ʻaʻole e hana ʻia ka syntax formatting Markdown ma waena o nā hōʻailona poloka HTML.No ka laʻana, inā ʻoe e hoʻohana i kahi ʻano Markdown i loko o kahi poloka HTML*强调*ʻaʻohe hopena.

ʻO nā ʻāpana HTML (inline) e like me <span>,<cite>,<del> Hiki ke hoʻohana manuahi ʻia ma nā paukū Markdown, nā papa inoa a i ʻole nā ​​poʻo.E like me nā hana pilikino, hiki iā ʻoe ke hoʻohana i nā hōʻailona HTML e hoʻohālikelike me ka ʻole o ka hoʻohana ʻana i ka format Markdown.Laʻana: Inā makemake ʻoe i ka HTML <a> 或 <img> nā hōʻailona, ​​hiki ke hoʻohana pololei ʻia me ka ʻole o ka loulou a i ʻole syntax tag kiʻi i hāʻawi ʻia e Markdown.

ʻAʻole like ma waena o nā hōʻailona poloka HTML, kūpono ʻo Markdown syntax ma waena o nā ʻāpana HTML.

Hoʻololi 'akomi o nā hua'ōlelo kūikawā

Ma nā faila HTML, ʻelua mau huaʻōlelo e pono ai ka lawelawe kūikawā: < a & . < Hoʻohana ʻia nā hōʻailona no nā hōʻailona hoʻomaka,& Hoʻohana ʻia nā hōʻailona e hōʻailona i nā mea HTML, inā makemake ʻoe e hōʻike i ka prototype o kēia mau ʻano, pono ʻoe e hoʻohana i ke ʻano hui, e like me < a &.

& Hoʻopilikia nui ʻia nā ʻano no nā mea kākau palapala pūnaewele, inā ʻoe e paʻi "AT&T", pono ʻoe e kākau "AT&T".ʻoiai ma ka URL & Hoʻololi pū ʻia nā huapalapala.No ka laʻana makemake ʻoe e loulou i:

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

Pono ʻoe e kākau i ka huli ʻana o ka URL e like me:

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

e kau ʻia ma ka tag loulou href ma na waiwai.ʻAʻole pono e ʻōlelo, maʻalahi kēia e haʻalele, a ʻo ka hapa nui paha o nā hewa i ʻike ʻia e ka hōʻoia ʻana i nā kūlana HTML.

Hāʻawi ʻo Markdown iā ʻoe e kākau i nā huapalapala maʻamau, a mālama ia i nā mea e pono ai ke hoʻololi ʻia.inā ʻoe e hoʻohana & ʻO kahi ʻano he ʻāpana o kahi ʻano HTML, waiho ʻia e like me ia, i ʻole e hoʻololi ʻia i &;.

No laila inā makemake ʻoe e hoʻokomo i kahi hōʻailona kope i loko o ka palapala ©, hiki iā ʻoe ke kākau:

©

E waiho ʻo Markdown me ka ʻole.A inā ʻoe e kākau:

AT&T

E hoʻololi ʻo Markdown iā ia i:

AT&T

Aia kekahi kūlana like ma < notation, no ka mea, ʻae ʻo Markdown i ka hoʻohālikelike HTML, inā ʻoe e kau < Hoʻohana ʻia nā hōʻailona ma ke ʻano he palena no nā tag HTML, a ʻaʻole e hana ʻo Markdown i nā hoʻololi ʻana iā lākou, akā inā ʻoe e kākau:

4 < 5

E hoʻololi ʻo Markdown iā ia i:

4 < 5

Eia naʻe, pono e hoʻomaopopo ʻia i loko o ke ʻano o ke code, inā he inline a poloka paha, < a & nā hōʻailona ʻeluahōʻoiaiʻoua hoʻololi ʻia i nā mea HTML, kahi hiʻohiʻona e hiki ai iā ʻoe ke kākau maʻalahi i ka code HTML ma Markdown (e kūʻē i ka HTML, kahi āu e kau ai i nā mea āpau. < a & Hoʻololi ʻia nā mea a pau i nā mea HTML, i mea e kākau ai i ka code HTML ma ka faila HTML. )

mea poloka

Nā paukū a me nā laina laina

ʻO ka paukū Markdown he hoʻokahi a ʻoi aʻe paha nā laina o nā kikokikona, ma mua a hahai ʻia e nā laina hakahaka ʻoi aku ma mua o hoʻokahi (ʻo ka wehewehe ʻana o kahi laina hakahaka, ʻo ia ka mea i ʻike ʻia he hakahaka ma ka hōʻike a manaʻo ʻia he laina hakahaka. No ka laʻana, , inā loaʻa i kahi laina nā hakahaka a me nā ʻaoʻao wale nō, e mālama ʻia ka laina ma ke ʻano he laina hakahaka).ʻAʻole pono e hoʻokomo ʻia nā paukū maʻamau me nā hakahaka a i ʻole nā ​​papa.

ʻO ka huaʻōlelo "i loko o hoʻokahi a ʻoi aku paha nā laina ʻokoʻa o ka kikokikona" ʻo ia ka manaʻo e ʻae ʻo Markdown i nā laina hou i koi ʻia (hoʻokomo i nā laina hou) i loko o nā paukū, kahi hiʻohiʻona ʻokoʻa mai ka hapa nui o nā kikokikona-i-HTML format (me ka Movable Type "Convert Line Breaks. "koho), e hoʻololi nā ʻano ʻē aʻe i kēlā me kēia hoʻomaha laina i <br /> lepili

Inā 'oeʻoiaʻiʻoMakemake e hilinaʻi ma Markdown e hoʻokomo <br /> No nā lepili, e kaomi i ʻelua a ʻoi aku paha nā hakahaka ma ka wahi hoʻokomo a laila kaomi iā Enter.

ʻOiaʻiʻo, ʻoi aku ka liʻiliʻi o ka hana (nā hakahaka hou) e hana ai <br /> , akā "hoʻololi ʻia kēlā me kēia laina hou i <br />"ʻAʻole kūpono ke ala ma Markdown, em ma MarkdownaiʻAʻole ʻoi aku ka maikaʻi o nā ʻōlelo aʻoaʻo L-style a me nā papa inoa o nā paukū he nui akā maʻalahi hoʻi ke heluhelu ʻana i ka wā e hoʻonohonoho ʻia me nā haʻi laina.

Ke poʻo inoa

Kākoʻo ʻo Markdown i ʻelua syntax no nā poʻomanaʻo, Setext-like a me atx-like.

ʻO ke ʻano Settext-like ʻo ia ke ʻano me ka laina lalo, me ka hoʻohana ʻana = (ke poʻo inoa kiʻekiʻe loa) a - (Nā poʻomanaʻo kauoha lua), no ka laʻana:

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

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

kekahi huina = a - hiki ke hana pono.

Hoʻokomo ka ʻano like ʻo Atx i ka 1 a i ka 6 ma ka hoʻomaka o ka laina # , pili i nā poʻomanaʻo 1 a 6, no ka laʻana:

# 这是 H1

## 这是 H2

###### 这是 H6

Hiki iā ʻoe ke koho "pani" i nā poʻomanaʻo like-atx, maʻemaʻe kēia no ka aesthetics, inā ʻoluʻolu ʻoe i kēia ala, hiki iā ʻoe ke hoʻohui iā ia ma ka hope o ka laina. #, oiai e pau ana ka laina # ʻAʻole pono e like ka helu me ka hoʻomaka (ʻo ka helu o nā paona paona ma ka hoʻomaka o ka laina e hoʻoholo i ke ʻano o ke poʻo inoa):

# 这是 H1 #

## 这是 H2 ##

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

Hoʻopaʻa haʻahaʻa

Hoʻohana ʻia ka markdown markup blockquotes e like me nā mea i hoʻohana ʻia ma ka leka uila > o na huaolelo.Inā kamaʻāina ʻoe i nā huaʻōlelo ma nā leka leka uila, ʻike ʻoe i ka hana ʻana i kahi ʻōlelo poloka i loko o kahi faila Markdown, me he mea lā ʻoe e uhaki i nā laina iā ʻoe iho, a laila hoʻohui > :

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

ʻAe ʻo Markdown iā ʻoe e palaualelo a hoʻohui wale i ka laina mua o ka pauku holoʻokoʻa > :

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

Hiki ke hoʻopaʻa ʻia nā ʻōlelo poloka (e laʻa: nā kuhikuhi i loko o nā kuhikuhi) ma ka hoʻohui ʻana i kahi helu ʻokoʻa o > :

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

Hiki ke hoʻohana ʻia nā syntax ʻē aʻe Markdown i loko o nā poloka i ʻōlelo ʻia, me nā poʻomanaʻo, nā papa inoa, nā poloka code, etc.:

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

Hiki i nā mea hoʻoponopono kikokikona kūpono ke hana maʻalahi i nā huaʻōlelo leka uila.No ka laʻana ma BBEdit hiki iā ʻoe ke koho i ka kikokikona a laila koho mai ka papa kuhikuhihoʻonui i ka hierarchy kuhi.

Nākini

Kākoʻo ʻo Markdown i nā papa inoa kauoha ʻole ʻia.

Hoʻohana nā papa inoa ʻole i nā asterisk, nā hōʻailona hoʻohui, a i ʻole nā ​​hōʻailona hōʻemi e like me nā māka papa inoa:

*   Red
*   Green
*   Blue

E like me:

+   Red
+   Green
+   Blue

Ua like pū me:

-   Red
-   Green
-   Blue

Hoʻohana nā papa inoa kauoha i nā helu i ukali ʻia e kahi manawa:

1.  Bird
2.  McHale
3.  Parish

He mea nui e hoʻomaopopo ʻaʻole pili nā helu āu e hoʻohana ai ma ka hōʻailona papa inoa i ka HTML puka.

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

Inā kākau ʻia kāu hōʻailona papa inoa e like me:

1.  Bird
1.  McHale
1.  Parish

a i ʻole:

3. Bird
1. McHale
8. Parish

E loaʻa iā ʻolua ka hoʻopuka HTML like.ʻO ka manaʻo, hiki iā ʻoe ke hana i nā helu papa inoa ma ka faila Markdown e like me nā hopena hoʻopuka, a inā palaualelo ʻoe, ʻaʻole pono ʻoe e mālama i ka pololei o nā helu.

Inā hoʻohana ʻoe i ke kākau palaualelo, pono e hoʻomaka me 1. no ka mea mua, no ka mea hiki ke kākoʻo ʻo Markdown i ke ʻano hoʻomaka o nā papa inoa i kauoha ʻia i ka wā e hiki mai ana.

Hoʻokomo pinepine ʻia ka hōʻailona ʻikamu papa inoa ma ka ʻaoʻao hema loa, akā hiki ke hoʻokomo ʻia, a hiki i 3 mau hakahaka, a pono e hahai ʻia ka hōʻailona ʻikamu e kahi liʻiliʻi a i ʻole ka pā.

I mea e nani ai ka papa inoa, hiki iā ʻoe ke hoʻonohonoho i nā mea me kahi indent paʻa:

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

Akā inā moloā ʻoe, maikaʻi nō hoʻi:

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

Inā hoʻokaʻawale ʻia nā mea papa inoa e nā laina hakahaka, e hoʻohana ʻo Markdown i ka ʻikepili i ka wā e hoʻopuka ai i ka HTML. <p> Hoʻopili ʻia nā lepili, no ka laʻana:

*   Bird
*   Magic

e hoʻololi ʻia i:

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

Akā ʻo kēia:

*   Bird

*   Magic

e hoʻololi ʻia i:

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

Hiki i nā mea papa inoa ke loaʻa nā paukū he nui, a pono e hoʻokomo ʻia nā paukū ma lalo o kēlā me kēia ʻikamu e nā hakahaka 4 a i ʻole 1 papa:

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.

ʻOi aku ka maikaʻi inā ʻoe e hoʻokomo i kēlā me kēia laina, ʻoiaʻiʻo, hou, inā palaualelo ʻoe, ʻae pū ʻo Markdown:

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

Inā makemake ʻoe e kau i kahi kuhikuhi i loko o kahi mea papa inoa, a laila > Pono e hoʻopaʻa ʻia:

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

Inā makemake ʻoe e kau i kahi poloka code, pono e hoʻokomo ʻia ka polokapālua, he 8 mau hakahaka a i ʻole 2 mau papa:

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

        <代码写在这>

ʻOiaʻiʻo, hiki ke hana ʻia kahi papa inoa o nā mea, e like me kēia:

1986. What a great season.

ʻO ia hoʻi, ʻike ʻia ma ka hoʻomaka o ka lainahelu-manawa-blank, no ka pale ʻana i kēia, hiki iā ʻoe ke hoʻohui i kahi backslash ma mua o ka manawa.

1986\. What a great season.

poloka code

ʻO ke kākau ʻana a i ʻole ka ʻōlelo hōʻailona e pili ana i ka papahana, ua loaʻa i nā poloka code typeset. <pre> a <code> nā hōʻailona e hoʻopili i nā poloka code.

He maʻalahi ke kūkulu ʻana i nā poloka o ke code ma Markdown e like me ka hoʻokomo ʻana i 4 mau hakahaka a i ʻole 1 ʻaoʻao, no ka laʻana, e komo i kēia:

这是一个普通段落：

    这是一个代码区块。

E hoʻololi ʻia ʻo Markdown i:

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

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

Hoʻopau ʻia kēia ʻōkuhi kauoha mua ma kēlā me kēia laina (4 mau hakahaka a i ʻole 1 ʻaoʻao), no ka laʻana:

Here is an example of AppleScript:

    tell application "Foo"
        beep
    end tell

e hoʻololi ʻia i:

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

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

Hoʻomau ʻia kahi poloka o ke code a hiki i ka laina ʻole (a i ʻole ka hopena o ka faila).

I loko o ka poloka code, & , < a > E hoʻololi 'akomiʻia ia i nā mea HTML. He mea maʻalahi kēiaʻano iāʻoe e hoʻohana iā Markdown e hoʻokomo i ka code source HTML no ka laʻana, e kope wale a paʻi, e hoʻohui i ka indentation, a na ke koena Markdown e lawelawe iā ia noʻoe, no ka mea, laʻana:

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

e hoʻololi ʻia i:

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

Ma ka poloka code, ʻaʻole e hoʻololi ʻia ka syntax maʻamau Markdown, e like me nā asterisk he asterisk wale nō, ʻo ia ka mea hiki iā ʻoe ke kākau maʻalahi i nā faila pili pili i ka Markdown syntax ma Markdown syntax.

mea hoʻokaʻawale

Hiki iā ʻoe ke hana i ka mea hoʻokaʻawale me nā asterisk ʻoi aku ma mua o ʻekolu, nā hōʻailona hōʻemi, nā kaha lalo i kahi laina, ʻaʻohe mea ʻē aʻe ma ka laina.Hiki iā ʻoe ke hoʻokomo i nā hakahaka ma waena o nā asterisk a i ʻole nā ​​hōʻailona hōʻemi.Hiki ke hana ʻia nā laina hoʻokaʻawale ma kēlā me kēia ʻano o ke kākau ʻana:

* * *

***

*****

- - -

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

ʻāpana ʻāpana

loulou

Kākoʻo ʻo Markdown i ʻelua ʻano o ka syntax loulou: InlineaKuhikuhiʻelua ʻano.

ʻO kēlā me kēia ʻaoʻao, hōʻailona ʻia nā kikokikona loulou me [nā pūʻali huinahā].

e hana i kahiInlineInā makemake ʻoe e hoʻohui i ka kikokikona poʻo inoa o ka loulou, e kāʻei wale i ke poʻo inoa me nā kaha puʻi pālua ma hope o ka URL, no ka laʻana:

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

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

E hana mai:

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

Inā pili ʻoe i nā kumuwaiwai ma ka host hoʻokahi, hiki iā ʻoe ke hoʻohana i nā ala pili:

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

KuhikuhiHahai ʻia ka loulou e kekahi bracket huinaha hou ma hope o ka bracket o ka kikokikona loulou, a ʻo ka māka i hoʻohana ʻia no ka ʻike ʻana i ka loulou pono e hoʻopiha ʻia i ka bracket huinahā lua:

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

Hiki iā ʻoe ke kau i kahi hakahaka ma waena o nā bracket square ʻelua:

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

A laila, ma nā wahi āpau o ka faila, hiki iā ʻoe ke wehewehe i ka maʻiʻo loulou o kēia tag:

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

Ua wehewehe ʻia ka loulou ma ke ʻano:

• ʻO nā bracket square (ke koho ʻia ma mua o ʻekolu mau hakahaka no ka indentation) kahi i hoʻokomo ʻia ai nā kikokikona loulou
• ukali ʻia e kahi kolonā
• ukali ʻia e hoʻokahi a ʻoi aku paha nā hakahaka a i ʻole nā ​​papa
• ka URL o ka loulou e hiki mai ana
• E hahai i ka maʻiʻo o ke poʻo inoa, hiki ke hoʻopaʻa ʻia i loko o nā huaʻōlelo hoʻokahi, ʻōlelo pālua, a i ʻole nā ​​pale.

Ua like nā wehewehena o nā loulou ʻekolu:

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

ʻaʻole e mālama:Aia kahi pilikia i ʻike ʻia ma kahi o Markdown.pl 1.0.1 e nānā ʻole i nā poʻo inoa loulou i hoʻopaʻa ʻia ma nā puʻupuʻu hoʻokahi.

Hiki ke hoʻopaʻa ʻia nā loulou URL ma nā bracket angle:

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

Hiki iā ʻoe ke kau i ke ʻano inoa ma ka laina aʻe, a i ʻole e hoʻohui i kekahi indentation, e ʻoi aku ka maikaʻi inā lōʻihi ka URL:

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

Hoʻohana wale ʻia ka wehewehe URL i ka wā e hana ai i ka loulou, a ʻaʻole ʻike pololei ʻia i ka faila.

Loaʻa paha nā leka, nā helu, nā wahi keʻokeʻo, a me nā kaha kikoʻī i loko o nā hōʻailona loulou, akā ʻaʻoleʻAʻoleHe mea maʻalahi ia, no laila ua like nā loulou ʻelua:

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

Lepili loulou piliHiki iā ʻoe ke haʻalele i ka hōʻike ʻana i kahi lepili loulou. I kēia hihia, e mālama ʻia ka tag loulou e like me ke kikokikona loulou. " Ma ka loulou i google.com, hiki iā ʻoe ke maʻalahi i:

[Google][]

A laila e wehewehe i ka maʻiʻo loulou:

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

No ka mea, loaʻa paha i nā kikokikona loulou nā wahi keʻokeʻo, hiki i kēia markup maʻalahi ke loaʻa nā huaʻōlelo he nui:

Visit [Daring Fireball][] for more information.

A laila hele e wehewehe i ka loulou:

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

Hiki ke waiho ʻia ka wehewehe ʻana o ka loulou ma nā wahi ʻē aʻe o ka faila. Makemake au e kau pololei ma hope o ka paukū kahi i ʻike ʻia ai ka loulou. Hiki iā ʻoe ke kau ma ka hope o ka faila, e like me ka manaʻo.

Eia kekahi laʻana o kahi loulou kuhikuhi:

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"

Inā hoʻololi ʻoe iā ia e hoʻohana i ka inoa loulou e kākau:

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"

ʻO nā ala kākau ʻelua ma luna nei e hana i kēia HTML.

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

Aia ma lalo kahi faila Markdown o ka ʻike like i kākau ʻia i loko o ka laina, hāʻawi ʻia no ka hoʻohālikelike:

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

ʻO ka ʻoiaʻiʻo, ʻaʻole i maʻalahi ka kākau ʻana i ke ʻano o nā loulou, akā ʻoi aku ka maʻalahi o ka heluhelu ʻana. E hoʻohālikelike i ka laʻana i luna. 81 huapalapala. , inā kākau ʻia ma ka ʻano HTML maʻemaʻe, he 176. Ma ka hōʻano HTML, ʻoi aku ka nui o nā hōʻailona ma mua o ka kikokikona.

Me ka hoʻohana ʻana i nā loulou ʻano kuhikuhi a Markdown, hiki iā ʻoe ke hana i ka palapala e like me ka hopena hope o ka polokalamu kele pūnaewele, e ʻae iā ʻoe e hoʻoneʻe i kekahi metadata pili i ka markup ma waho o ka paukū kikokikona, a hiki iā ʻoe ke hoʻohui i nā loulou me ka ʻole o ka heluhelu ʻana i ka ʻatikala. .

Kākoʻo

Hoʻohana ʻo Markdown i nā asterisk (*) a me ka laina lalo (_) ma ke ʻano he hōʻailona e hōʻailona ai i kahi huaʻōlelo i kaha ʻia, ʻo ia * 或 _ Hoʻololi ʻia nā huaʻōlelo hoʻopuni i <em> hoʻopuni ʻia e nā lepili, me ʻelua * 或 _Ina ua wahī ia, e hoololi ia i <strong>, E.g:

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

e lilo i:

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

Hiki iā ʻoe ke hoʻohana i ke ʻano āu e makemake ai, ʻo ka palena wale nō hiki iā ʻoe ke wehe i ka tag me kahi hōʻailona āu e makemake ai e hoʻopau.

Hiki ke hoʻokomo pololei ʻia ka manaʻo koʻikoʻi i waenakonu o ke kikokikona:

un*frigging*believable

aka, akainā kāu * a _ Inā loaʻa nā wahi keʻokeʻo ma nā ʻaoʻao ʻelua, mālama ʻia lākou e like me nā hōʻailona maʻamau.

No ka hoʻokomo ʻana i nā asterisk maʻamau a i ʻole nā ​​kaha kaha ma mua a ma hope o ke kikokikona, hiki iā ʻoe ke hoʻohana i nā kaha kua.

\*this text is surrounded by literal asterisks\*

Pāʻālua

Inā makemake ʻoe e kaha i kahi ʻāpana liʻiliʻi o ke code inline, hiki iā ʻoe ke wahī iā ia i ka backtick (`), E.g:

Use the `printf()` function.

E hana mai:

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

Inā makemake ʻoe e hoʻokomo i nā backticks i loko o kahi ʻāpana code, hiki iā ʻoe ke hoʻomaka a hoʻopau i ka ʻāpana code me nā backticks lehulehu:

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

Hoʻopuka kēia syntax:

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

Hiki iā ʻoe ke waiho i kahi hakahaka ma ka hoʻomaka a me ka hopena o kahi ʻāpana code, hoʻokahi ma hope o ka hoʻomaka a hoʻokahi ma mua o ka hopena, no laila hiki iā ʻoe ke hoʻokomo i nā backticks ma ka hoʻomaka o ka ʻāpana:

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

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

E hana mai:

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

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

I loko o ka ʻāpana code,& a me nā pale kihi都E hoʻololi koke ʻia i nā mea HTML, kahi e maʻalahi ai ke hoʻokomo i ka code kumu HTML, e kau ʻo Markdown i kēia paukū:

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

i:

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

Hiki iā ʻoe ke kākau i kēia:

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

No ka hana ʻana:

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

图片

ʻIke loa, paʻakikī ka hoʻolālā ʻana i kahi syntax "kūlohelohe" no ka hoʻokomo ʻana i nā kiʻi i loko o kahi noi kikokikona wale nō.

Hoʻohana ʻo Markdown i kahi syntax e like me nā loulou e hōʻailona i nā kiʻi, a ʻae pū i ʻelua ʻano: InlineaKuhikuhi.

Ua like ke ʻano o ka syntax kiʻi inline:

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

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

Penei nā kikoʻī:

• he kaha hoailona !
• a ukali ʻia e kahi bracket square me kahi kikokikona alt no ke kiʻi
• A laila he bracket maʻamau, e hoʻokomo i ka URL o ke kiʻi i loko, a hoʻopaʻa hope iā ia i nā huaʻōlelo a hoʻohui i kahi kikokikona 'title' koho.

Penei ke ʻano o ka syntax kiʻi kuhikuhi:

![Alt text][id]

ʻO "id" ka inoa o ke kiʻi kuhikuhi, i wehewehe ʻia ma ke ʻano like me kahi kuhikuhi loulou:

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

I kēia manawa, ʻaʻohe ala ʻo Markdown e kuhikuhi i ka laulā a me ke kiʻekiʻe o ke kiʻi, inā pono ʻoe, hiki iā ʻoe ke hoʻohana i ka mea maʻamau. <img> lepili

其它

loulou auto

Kākoʻo ʻo Markdown i ka hoʻoponopono ʻana i nā URL a me nā leka uila ma ke ʻano o nā loulou pōkole pōkole.Ua like ka kikokikona loulou o ka URL maʻamau me ka helu wahi loulou, no ka laʻana:

<http://example.com/>

E hoʻololi ʻia ʻo Markdown i:

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

Ua like pū ka loulou ʻakomi o nā helu leka uila, koe wale nō e hana mua ʻo Markdown i kahi kaʻina hoʻololi hoʻololi hoʻololi, e hoʻohuli ana i nā huaʻōlelo i loko o nā mea HTML hexadecimal.

<[email protected]>

E lilo ka Markdown i:

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

Ma ka polokalamu kele pūnaewele, kēia string (ʻoiaʻiʻo <a href="mailto:[email protected]">[email protected]</a>) lilo i loulou "[email protected]" hiki ke kaomi.

(ʻOiai hiki i kēia ala ke hoʻopunipuni i nā robots he nui, ʻaʻole hiki iā ia ke hoʻōki iā lākou a pau, akā ʻoi aku ka maikaʻi ma mua o ka ʻole. ʻOiai, ʻo ka wehe ʻana i kāu pahu leta e huki i nā leka hoʻolaha.)

kaha kua hope

Hiki iā Markdown ke hoʻohana i nā ʻāpana hope e hoʻokomo i nā hōʻailona i loaʻa nā manaʻo ʻē aʻe i ka grammar, no ka laʻana: inā makemake ʻoe e hoʻohui i kahi asterisk ma hope o ka kikokikona no ke koʻikoʻi (akā ʻaʻole. <em> tag), hiki iā ʻoe ke hele i mua o ka asterisk me kahi kuapo hope:

\*literal asterisks\*

Kākoʻo ʻo Markdown i nā hōʻailona ma mua o ka backslash e kōkua i ka hoʻokomo ʻana i nā hōʻailona maʻamau:

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

Hoʻoponopono manuahi ʻo Markdown

paepae Windows

• MarkdownPad
• MarkPad

kahua Mac

• pahee

hoʻoponopono pūnaewele

• MPEditor

polokalamu kele pūnaewele

• Markdown maanei plugin

*** Inā loaʻa kahi mea hoʻoponopono Markdown manuahi ʻoi aku ka maikaʻi e ʻōlelo aku, e ʻoluʻolu e hoʻolohe i ka manaʻoChen Weiliang,mahalo!