<< [訪問 Wow!Ubuntu](http://wowubuntu.com)**NOTE:** This is Simplelified Chinese Edition Document of Markdown Syntax. If you are seeking for English Edition Document. Please refer to [Markdown: Syntax][eng-doc].[eng-doc]:http://daringfireball.net/projects/markdown/syntax**聲明：** 這份文檔派生(fork)于[繁體中文版](http://markdown.tw/)，在此基礎(chǔ)上進(jìn)行了繁體轉(zhuǎn)簡(jiǎn)體工作，并進(jìn)行了適當(dāng)?shù)臐?rùn)色。此文檔用 Markdown 語(yǔ)法編寫，你可以到這里[查看它的源文件][src1]。「繁體中文版的原始文件可以[查看這里][src] 。」--By @[riku][t]**注：** 本項(xiàng)目托管于 [GitCafe][]上，請(qǐng)通過"派生"和"合并請(qǐng)求"來幫忙改進(jìn)本項(xiàng)目。 [src1]: http://gitcafe.com/riku/Markdown-Syntax-CN/blob/master/syntax.md [src]: https://github.com/othree/markdown-syntax-zhtw/blob/master/syntax.md [t]: http://twitter.com/riku [g]: http://gitcafe.com/riku/Markdown-Syntax-CN [Github]: https://github.com/riku/Markdown-Syntax-CN [GitCafe]: http://gitcafe.com/riku/Markdown-Syntax-CN/Markdown 語(yǔ)法說明 (簡(jiǎn)體中文版) / ([點(diǎn)擊查看快速入門](./basic.html))================* [概述](#overview) * [宗旨](#philosophy) * [兼容 HTML](#html) * [特殊字符自動(dòng)轉(zhuǎn)換](#autoescape)* [區(qū)塊元素](#block) * [段落和換行](#p) * [標(biāo)題](#header) * [區(qū)塊引用](#blockquote) * [列表](#list) * [代碼區(qū)塊](#precode) * [分隔線](#hr)* [區(qū)段元素](#span) * [鏈接](#link) * [強(qiáng)調(diào)](#em) * [代碼](#code) * [圖片](#img)* [其它](#misc) * [反斜杠](#backslash) * [自動(dòng)鏈接](#autolink)* [感謝](#acknowledgement)*[Markdown 免費(fèi)編輯器](#editor)* * *

概述

宗旨

Markdown 的目標(biāo)是實(shí)現(xiàn)「易讀易寫」。可讀性，無論如何，都是最重要的。一份使用 Markdown 格式撰寫的文件應(yīng)該可以直接以純文本發(fā)布，并且看起來不會(huì)像是由許多標(biāo)簽或是格式指令所構(gòu)成。Markdown 語(yǔ)法受到一些既有 text-to-HTML 格式的影響，包括 [Setext] [1]、[atx] [2]、[Textile] [3]、[reStructuredText] [4]、[Grutatext] [5] 和 [EtText] [6]，而最大靈感來源其實(shí)是純文本電子郵件的格式。? [1]: http://docutils.sourceforge.net/mirror/setext.html? [2]: http://www.aaronsw.com/2002/atx/? [3]: http://textism.com/tools/textile/? [4]: http://docutils.sourceforge.net/rst.html? [5]: http://www.triptico.com/software/grutatxt.html? [6]: http://ettext.taint.org/doc/總之， Markdown 的語(yǔ)法全由一些符號(hào)所組成，這些符號(hào)經(jīng)過精挑細(xì)選，其作用一目了然。比如：在文字兩旁加上星號(hào)，看起來就像\*強(qiáng)調(diào)\*。Markdown 的列表看起來，嗯，就是列表。Markdown 的區(qū)塊引用看起來就真的像是引用一段文字，就像你曾在電子郵件中見過的那樣。

兼容 HTML

Markdown 語(yǔ)法的目標(biāo)是：成為一種適用于網(wǎng)絡(luò)的*書寫*語(yǔ)言。Markdown 不是想要取代 HTML，甚至也沒有要和它相近，它的語(yǔ)法種類很少，只對(duì)應(yīng) HTML 標(biāo)記的一小部分。Markdown 的構(gòu)想*不是*要使得 HTML 文檔更容易書寫。在我看來， HTML 已經(jīng)很容易寫了。Markdown 的理念是，能讓文檔更容易讀、寫和隨意改。HTML 是一種*發(fā)布*的格式，Markdown 是一種*書寫*的格式。就這樣，Markdown 的格式語(yǔ)法只涵蓋純文本可以涵蓋的范圍。不在 Markdown 涵蓋范圍之內(nèi)的標(biāo)簽，都可以直接在文檔里面用 HTML 撰寫。不需要額外標(biāo)注這是 HTML 或是 Markdown；只要直接加標(biāo)簽就可以了。要制約的只有一些 HTML 區(qū)塊元素――比如 `

`、``、`

`、`

` 等標(biāo)簽，必須在前后加上空行與其它內(nèi)容區(qū)隔開，還要求它們的開始標(biāo)簽與結(jié)尾標(biāo)簽不能用制表符或空格來縮進(jìn)。Markdown 的生成器有足夠智能，不會(huì)在 HTML 區(qū)塊標(biāo)簽外加上不必要的 `

` 標(biāo)簽。

例子如下，在 Markdown 文件里加上一段 HTML 表格：

這是一個(gè)普通段落。

Foo

這是另一個(gè)普通段落。請(qǐng)注意，在 HTML 區(qū)塊標(biāo)簽間的 Markdown 格式語(yǔ)法將不會(huì)被處理。比如，你在 HTML 區(qū)塊內(nèi)使用 Markdown 樣式的`*強(qiáng)調(diào)*`會(huì)沒有效果。HTML 的區(qū)段（行內(nèi)）標(biāo)簽如 ``、``、`` 可以在 Markdown 的段落、列表或是標(biāo)題里隨意使用。依照個(gè)人習(xí)慣，甚至可以不用 Markdown 格式，而直接采用 HTML 標(biāo)簽來格式化。舉例說明：如果比較喜歡 HTML 的 `` 或 `` 標(biāo)簽，可以直接使用這些標(biāo)簽，而不用 Markdown 提供的鏈接或是圖像標(biāo)簽語(yǔ)法。和處在 HTML 區(qū)塊標(biāo)簽間不同，Markdown 語(yǔ)法在 HTML 區(qū)段標(biāo)簽間是有效的。

特殊字符自動(dòng)轉(zhuǎn)換

在 HTML 文件中，有兩個(gè)字符需要特殊處理： `<` 和 `&` 。 `<` 符號(hào)用于起始標(biāo)簽，`&` 符號(hào)則用于標(biāo)記 HTML 實(shí)體，如果你只是想要顯示這些字符的原型，你必須要使用實(shí)體的形式，像是 `<` 和 `&`。`&` 字符尤其讓網(wǎng)絡(luò)文檔編寫者受折磨，如果你要打「`AT&T`」 ，你必須要寫成「`AT&T`」。而網(wǎng)址中的 `&` 字符也要轉(zhuǎn)換。比如你要鏈接到：? ? http://images.google.com/images?num=30&q=larry+bird你必須要把網(wǎng)址轉(zhuǎn)換寫為：? ? http://images.google.com/images?num=30&q=larry+bird才能放到鏈接標(biāo)簽的 `href` 屬性里。不用說也知道這很容易忽略，這也可能是 HTML 標(biāo)準(zhǔn)檢驗(yàn)所檢查到的錯(cuò)誤中，數(shù)量最多的。Markdown 讓你可以自然地書寫字符，需要轉(zhuǎn)換的由它來處理好了。如果你使用的 `&` 字符是 HTML 字符實(shí)體的一部分，它會(huì)保留原狀，否則它會(huì)被轉(zhuǎn)換成 `&`;。所以你如果要在文檔中插入一個(gè)版權(quán)符號(hào) `?`，你可以這樣寫：? ? ?Markdown 會(huì)保留它不動(dòng)。而若你寫：? ? AT&TMarkdown 就會(huì)將它轉(zhuǎn)為：? ? AT&T類似的狀況也會(huì)發(fā)生在 `<` 符號(hào)上，因?yàn)?Markdown 允許 [兼容 HTML](#html) ，如果你是把 `<` 符號(hào)作為 HTML 標(biāo)簽的定界符使用，那 Markdown 也不會(huì)對(duì)它做任何轉(zhuǎn)換，但是如果你寫：? ? 4 < 5Markdown 將會(huì)把它轉(zhuǎn)換為：? ? 4 < 5不過需要注意的是，code 范圍內(nèi)，不論是行內(nèi)還是區(qū)塊， `<` 和 `&` 兩個(gè)符號(hào)都*一定*會(huì)被轉(zhuǎn)換成 HTML 實(shí)體，這項(xiàng)特性讓你可以很容易地用 Markdown 寫 HTML code （和 HTML 相對(duì)而言， HTML 語(yǔ)法中，你要把所有的 `<` 和 `&` 都轉(zhuǎn)換為 HTML 實(shí)體，才能在 HTML 文件里面寫出 HTML code。）* * *

區(qū)塊元素

段落和換行

一個(gè) Markdown 段落是由一個(gè)或多個(gè)連續(xù)的文本行組成，它的前后要有一個(gè)以上的空行（空行的定義是顯示上看起來像是空的，便會(huì)被視為空行。比方說，若某一行只包含空格和制表符，則該行也會(huì)被視為空行）。普通段落不該用空格或制表符來縮進(jìn)。「由一個(gè)或多個(gè)連續(xù)的文本行組成」這句話其實(shí)暗示了 Markdown 允許段落內(nèi)的強(qiáng)迫換行（插入換行符），這個(gè)特性和其他大部分的 text-to-HTML 格式不一樣（包括 Movable Type 的「Convert Line Breaks」選項(xiàng)），其它的格式會(huì)把每個(gè)換行符都轉(zhuǎn)成 `

` 標(biāo)簽。如果你*確實(shí)*想要依賴 Markdown 來插入 `

` 標(biāo)簽的話，在插入處先按入兩個(gè)以上的空格然后回車。的確，需要多費(fèi)點(diǎn)事（多加空格）來產(chǎn)生 `

` ，但是簡(jiǎn)單地「每個(gè)換行都轉(zhuǎn)換為 `

`」的方法在 Markdown 中并不適合， Markdown 中 email 式的 [區(qū)塊引用][bq] 和多段落的 [列表][l] 在使用換行來排版的時(shí)候，不但更好用，還更方便閱讀。? [bq]: #blockquote? [l]:? #list

標(biāo)題

Markdown 支持兩種標(biāo)題的語(yǔ)法，類 [Setext] [1] 和類 [atx] [2] 形式。類 Setext 形式是用底線的形式，利用 `=` （最高階標(biāo)題）和 `-` （第二階標(biāo)題），例如：? ? This is an H1? ? =============? ? This is an H2? ? -------------任何數(shù)量的 `=` 和 `-` 都可以有效果。類 Atx 形式則是在行首插入 1 到 6 個(gè) `#` ，對(duì)應(yīng)到標(biāo)題 1 到 6 階，例如：? ? # 這是 H1? ? ## 這是 H2? ? ###### 這是 H6你可以選擇性地「閉合」類 atx 樣式的標(biāo)題，這純粹只是美觀用的，若是覺得這樣看起來比較舒適，你就可以在行尾加上 `#`，而行尾的 `#` 數(shù)量也不用和開頭一樣（行首的井字符數(shù)量決定標(biāo)題的階數(shù)）：? ? # 這是 H1 #? ? ## 這是 H2 ##? ? ### 這是 H3 ######

區(qū)塊引用 Blockquotes

Markdown 標(biāo)記區(qū)塊引用是使用類似 email 中用 `>` 的引用方式。如果你還熟悉在 email 信件中的引言部分，你就知道怎么在 Markdown 文件中建立一個(gè)區(qū)塊引用，那會(huì)看起來像是你自己先斷好行，然后在每行的最前面加上 `>` ：? ? > 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 也允許你偷懶只在整個(gè)段落的第一行最前面加上 `>` ：? ? > 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.區(qū)塊引用可以嵌套（例如：引用內(nèi)的引用），只要根據(jù)層次加上不同數(shù)量的 `>` ：? ? > This is the first level of quoting.? ? >? ? > > This is nested blockquote.? ? >? ? > Back to the first level.引用的區(qū)塊內(nèi)也可以使用其他的 Markdown 語(yǔ)法，包括標(biāo)題、列表、代碼區(qū)塊等：> ## 這是一個(gè)標(biāo)題。> > 1.? 這是第一行列表項(xiàng)。> 2.? 這是第二行列表項(xiàng)。> > 給出一些例子代碼：> >? ? return shell_exec("echo $input | $markdown_script");任何像樣的文本編輯器都能輕松地建立 email 型的引用。例如在 BBEdit 中，你可以選取文字后然后從選單中選擇*增加引用階層*。

列表

Markdown 支持有序列表和無序列表。無序列表使用星號(hào)、加號(hào)或是減號(hào)作為列表標(biāo)記：? ? *? Red? ? *? Green? ? *? Blue等同于：? ? +? Red? ? +? Green? ? +? Blue也等同于：? ? -? Red? ? -? Green? ? -? Blue有序列表則使用數(shù)字接著一個(gè)英文句點(diǎn)：? ? 1.? Bird? ? 2.? McHale? ? 3.? Parish很重要的一點(diǎn)是，你在列表標(biāo)記上使用的數(shù)字并不會(huì)影響輸出的 HTML 結(jié)果，上面的列表所產(chǎn)生的 HTML 標(biāo)記為：

Bird

McHale

Parish

如果你的列表標(biāo)記寫成：? ? 1.? Bird? ? 1.? McHale? ? 1.? Parish或甚至是：? ? 3. Bird? ? 1. McHale? ? 8. Parish你都會(huì)得到完全相同的 HTML 輸出。重點(diǎn)在于，你可以讓 Markdown 文件的列表數(shù)字和輸出的結(jié)果相同，或是你懶一點(diǎn)，你可以完全不用在意數(shù)字的正確性。如果你使用懶惰的寫法，建議第一個(gè)項(xiàng)目最好還是從 1. 開始，因?yàn)?Markdown 未來可能會(huì)支持有序列表的 start 屬性。列表項(xiàng)目標(biāo)記通常是放在最左邊，但是其實(shí)也可以縮進(jìn)，最多 3 個(gè)空格，項(xiàng)目標(biāo)記后面則一定要接著至少一個(gè)空格或制表符。要讓列表看起來更漂亮，你可以把內(nèi)容用固定的縮進(jìn)整理好：? ? *? 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.但是如果你懶，那也行：? ? *? 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.如果列表項(xiàng)目間用空行分開，在輸出 HTML 時(shí) Markdown 就會(huì)將項(xiàng)目?jī)?nèi)容用 `

`

標(biāo)簽包起來，舉例來說：

*? Bird

*? Magic

會(huì)被轉(zhuǎn)換為：

Bird

Magic

但是這個(gè)：? ? *? Bird? ? *? Magic會(huì)被轉(zhuǎn)換為：

Bird

Magic

列表項(xiàng)目可以包含多個(gè)段落，每個(gè)項(xiàng)目下的段落都必須縮進(jìn) 4 個(gè)空格或是 1 個(gè)制表符：? ? 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.如果你每行都有縮進(jìn)，看起來會(huì)看好很多，當(dāng)然，再次地，如果你很懶惰，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.如果要在列表項(xiàng)目?jī)?nèi)放進(jìn)引用，那 `>` 就需要縮進(jìn)：? ? *? A list item with a blockquote:? ? ? ? > This is a blockquote? ? ? ? > inside a list item.如果要放代碼區(qū)塊的話，該區(qū)塊就需要縮進(jìn)*兩次*，也就是 8 個(gè)空格或是 2 個(gè)制表符：? ? *? 一列表項(xiàng)包含一個(gè)列表區(qū)塊：? ? ? ? ? ? <代碼寫在這>當(dāng)然，項(xiàng)目列表很可能會(huì)不小心產(chǎn)生，像是下面這樣的寫法：? ? 1986. What a great season.換句話說，也就是在行首出現(xiàn)*數(shù)字-句點(diǎn)-空白*，要避免這樣的狀況，你可以在句點(diǎn)前面加上反斜杠。? ? 1986\. What a great season.

代碼區(qū)塊

和程序相關(guān)的寫作或是標(biāo)簽語(yǔ)言原始碼通常會(huì)有已經(jīng)排版好的代碼區(qū)塊，通常這些區(qū)塊我們并不希望它以一般段落文件的方式去排版，而是照原來的樣子顯示，Markdown 會(huì)用 `

` 和 `` 標(biāo)簽來把代碼區(qū)塊包起來。要在 Markdown 中建立代碼區(qū)塊很簡(jiǎn)單，只要簡(jiǎn)單地縮進(jìn) 4 個(gè)空格或是 1 個(gè)制表符就可以，例如，下面的輸入：? ? 這是一個(gè)普通段落：? ? ? ? 這是一個(gè)代碼區(qū)塊。Markdown 會(huì)轉(zhuǎn)換成：

這是一個(gè)普通段落：

這是一個(gè)代碼區(qū)塊。

這個(gè)每行一階的縮進(jìn)（4 個(gè)空格或是 1 個(gè)制表符），都會(huì)被移除，例如：? ? Here is an example of AppleScript:? ? ? ? tell application "Foo"? ? ? ? ? ? beep? ? ? ? end tell會(huì)被轉(zhuǎn)換為：

Here is an example of AppleScript:

tell application "Foo"

beep

end tell

一個(gè)代碼區(qū)塊會(huì)一直持續(xù)到?jīng)]有縮進(jìn)的那一行（或是文件結(jié)尾）。在代碼區(qū)塊里面， `&` 、 `<` 和 `>` 會(huì)自動(dòng)轉(zhuǎn)成 HTML 實(shí)體，這樣的方式讓你非常容易使用 Markdown 插入范例用的 HTML 原始碼，只需要復(fù)制貼上，再加上縮進(jìn)就可以了，剩下的 Markdown 都會(huì)幫你處理，例如：

? 2004 Foo Corporation

會(huì)被轉(zhuǎn)換為：

? 2004 Foo Corporation

代碼區(qū)塊中，一般的 Markdown 語(yǔ)法不會(huì)被轉(zhuǎn)換，像是星號(hào)便只是星號(hào)，這表示你可以很容易地以 Markdown 語(yǔ)法撰寫 Markdown 語(yǔ)法相關(guān)的文件。

分隔線

你可以在一行中用三個(gè)以上的星號(hào)、減號(hào)、底線來建立一個(gè)分隔線，行內(nèi)不能有其他東西。你也可以在星號(hào)或是減號(hào)中間插入空格。下面每種寫法都可以建立分隔線：? ? * * *? ? ***? ? *****? ? - - -? ? ---------------------------------------* * *

區(qū)段元素

鏈接

Markdown 支持兩種形式的鏈接語(yǔ)法： *行內(nèi)式*和*參考式*兩種形式。不管是哪一種，鏈接文字都是用 [方括號(hào)] 來標(biāo)記。要建立一個(gè)*行內(nèi)式*的鏈接，只要在方塊括號(hào)后面緊接著圓括號(hào)并插入網(wǎng)址鏈接即可，如果你還想要加上鏈接的 title 文字，只要在網(wǎng)址后面，用雙引號(hào)把 title 文字包起來即可，例如：? ? This is [an example](http://example.com/ "Title") inline link.? ? [This link](http://example.net/) has no title attribute.會(huì)產(chǎn)生：This isan exampleinline link.

This linkhas no? ? title attribute.

如果你是要鏈接到同樣主機(jī)的資源，你可以使用相對(duì)路徑：? ? See my [About](/about/) page for details.? *參考式*的鏈接是在鏈接文字的括號(hào)后面再接上另一個(gè)方括號(hào)，而在第二個(gè)方括號(hào)里面要填入用以辨識(shí)鏈接的標(biāo)記：? ? This is [an example][id] reference-style link.你也可以選擇性地在兩個(gè)方括號(hào)中間加上一個(gè)空格：? ? This is [an example] [id] reference-style link.接著，在文件的任意處，你可以把這個(gè)標(biāo)記的鏈接內(nèi)容定義出來：? ? [id]: http://example.com/? "Optional Title Here"鏈接內(nèi)容定義的形式為：*? 方括號(hào)（前面可以選擇性地加上至多三個(gè)空格來縮進(jìn)），里面輸入鏈接文字*? 接著一個(gè)冒號(hào)*? 接著一個(gè)以上的空格或制表符*? 接著鏈接的網(wǎng)址*? 選擇性地接著 title 內(nèi)容，可以用單引號(hào)、雙引號(hào)或是括弧包著下面這三種鏈接的定義都是相同：[foo]: http://example.com/? "Optional Title Here"[foo]: http://example.com/? 'Optional Title Here'[foo]: http://example.com/? (Optional Title Here)**請(qǐng)注意：**有一個(gè)已知的問題是 Markdown.pl 1.0.1 會(huì)忽略單引號(hào)包起來的鏈接 title。鏈接網(wǎng)址也可以用尖括號(hào)包起來：? ? [id]:"Optional Title Here"你也可以把 title 屬性放到下一行，也可以加一些縮進(jìn)，若網(wǎng)址太長(zhǎng)的話，這樣會(huì)比較好看：? ? [id]: http://example.com/longish/path/to/resource/here? ? ? ? "Optional Title Here"網(wǎng)址定義只有在產(chǎn)生鏈接的時(shí)候用到，并不會(huì)直接出現(xiàn)在文件之中。鏈接辨別標(biāo)簽可以有字母、數(shù)字、空白和標(biāo)點(diǎn)符號(hào)，但是并*不*區(qū)分大小寫，因此下面兩個(gè)鏈接是一樣的：[link text][a][link text][A]*隱式鏈接標(biāo)記*功能讓你可以省略指定鏈接標(biāo)記，這種情形下，鏈接標(biāo)記會(huì)視為等同于鏈接文字，要用隱式鏈接標(biāo)記只要在鏈接文字后面加上一個(gè)空的方括號(hào)，如果你要讓 "Google" 鏈接到 google.com，你可以簡(jiǎn)化成：[Google][]然后定義鏈接內(nèi)容：[Google]: http://google.com/由于鏈接文字可能包含空白，所以這種簡(jiǎn)化型的標(biāo)記內(nèi)也許包含多個(gè)單詞：Visit [Daring Fireball][] for more information.然后接著定義鏈接：[Daring Fireball]: http://daringfireball.net/鏈接的定義可以放在文件中的任何一個(gè)地方，我比較偏好直接放在鏈接出現(xiàn)段落的后面，你也可以把它放在文件最后面，就像是注解一樣。下面是一個(gè)參考式鏈接的范例：? ? 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"如果改成用鏈接名稱的方式寫：? ? 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"上面兩種寫法都會(huì)產(chǎn)生下面的 HTML。

I get 10 times more traffic fromGooglethan fromYahooorMSN.

下面是用行內(nèi)式寫的同樣一段內(nèi)容的 Markdown 文件，提供作為比較之用：? ? 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").參考式的鏈接其實(shí)重點(diǎn)不在于它比較好寫，而是它比較好讀，比較一下上面的范例，使用參考式的文章本身只有 81 個(gè)字符，但是用行內(nèi)形式的卻會(huì)增加到 176 個(gè)字元，如果是用純 HTML 格式來寫，會(huì)有 234 個(gè)字元，在 HTML 格式中，標(biāo)簽比文本還要多。使用 Markdown 的參考式鏈接，可以讓文件更像是瀏覽器最后產(chǎn)生的結(jié)果，讓你可以把一些標(biāo)記相關(guān)的元數(shù)據(jù)移到段落文字之外，你就可以增加鏈接而不讓文章的閱讀感覺被打斷。

強(qiáng)調(diào)

Markdown 使用星號(hào)（`*`）和底線（`_`）作為標(biāo)記強(qiáng)調(diào)字詞的符號(hào)，被 `*` 或 `_` 包圍的字詞會(huì)被轉(zhuǎn)成用 `` 標(biāo)簽包圍，用兩個(gè) `*` 或 `_` 包起來的話，則會(huì)被轉(zhuǎn)成 ``，例如：? ? *single asterisks*? ? _single underscores_? ? **double asterisks**? ? __double underscores__會(huì)轉(zhuǎn)成：single asteriskssingle underscoresdouble asterisksdouble underscores你可以隨便用你喜歡的樣式，唯一的限制是，你用什么符號(hào)開啟標(biāo)簽，就要用什么符號(hào)結(jié)束。強(qiáng)調(diào)也可以直接插在文字中間：? ? un*frigging*believable但是**如果你的 `*` 和 `_` 兩邊都有空白的話，它們就只會(huì)被當(dāng)成普通的符號(hào)**。如果要在文字前后直接插入普通的星號(hào)或底線，你可以用反斜線：? ? \*this text is surrounded by literal asterisks\*

代碼

如果要標(biāo)記一小段行內(nèi)代碼，你可以用反引號(hào)把它包起來（`` ` ``），例如：? ? Use the `printf()` function.會(huì)產(chǎn)生：

Use theprintf()function.

如果要在代碼區(qū)段內(nèi)插入反引號(hào)，你可以用多個(gè)反引號(hào)來開啟和結(jié)束代碼區(qū)段：? ? ``There is a literal backtick (`) here.``這段語(yǔ)法會(huì)產(chǎn)生：

There is a literal backtick (`) here.

代碼區(qū)段的起始和結(jié)束端都可以放入一個(gè)空白，起始端后面一個(gè)，結(jié)束端前面一個(gè)，這樣你就可以在區(qū)段的一開始就插入反引號(hào)：A single backtick in a code span: `` ` ``A backtick-delimited string in a code span: `` `foo` ``會(huì)產(chǎn)生：

A single backtick in a code span:`

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

在代碼區(qū)段內(nèi)，`&` 和尖括號(hào)**都**會(huì)被自動(dòng)地轉(zhuǎn)成 HTML 實(shí)體，這使得插入 HTML 原始碼變得很容易，Markdown 會(huì)把下面這段：? ? Please don't use any `` tags.轉(zhuǎn)為：

Please don't use anytags.

你也可以這樣寫：? ? `—` is the decimal-encoded equivalent of `—`.以產(chǎn)生：

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

圖片

很明顯地，要在純文字應(yīng)用中設(shè)計(jì)一個(gè)「自然」的語(yǔ)法來插入圖片是有一定難度的。Markdown 使用一種和鏈接很相似的語(yǔ)法來標(biāo)記圖片，同樣也允許兩種樣式： *行內(nèi)式*和*參考式*。行內(nèi)式的圖片語(yǔ)法看起來像是：? ? ? ? 詳細(xì)敘述如下：*? 一個(gè)驚嘆號(hào) `!`*? 接著一個(gè)方括號(hào)，里面放上圖片的替代文字*? 接著一個(gè)普通括號(hào)，里面放上圖片的網(wǎng)址，最后還可以用引號(hào)包住并加上? ? 選擇性的 'title' 文字。參考式的圖片語(yǔ)法則長(zhǎng)得像這樣：? ? ![Alt text][id]「id」是圖片參考的名稱，圖片參考的定義方式則和連結(jié)參考一樣：? ? [id]: url/to/image? "Optional title attribute"到目前為止， Markdown 還沒有辦法指定圖片的寬高，如果你需要的話，你可以使用普通的 `` 標(biāo)簽。* * *

其它

自動(dòng)鏈接

Markdown 支持以比較簡(jiǎn)短的自動(dòng)鏈接形式來處理網(wǎng)址和電子郵件信箱，只要是用尖括號(hào)包起來， Markdown 就會(huì)自動(dòng)把它轉(zhuǎn)成鏈接。一般網(wǎng)址的鏈接文字就和鏈接地址一樣，例如：Markdown 會(huì)轉(zhuǎn)為：http://example.com/郵址的自動(dòng)鏈接也很類似，只是 Markdown 會(huì)先做一個(gè)編碼轉(zhuǎn)換的過程，把文字字符轉(zhuǎn)成 16 進(jìn)位碼的 HTML 實(shí)體，這樣的格式可以糊弄一些不好的郵址收集機(jī)器人，例如：Markdown 會(huì)轉(zhuǎn)成：address@exa

mple.com在瀏覽器里面，這段字串（其實(shí)是 `address@example.com`）會(huì)變成一個(gè)可以點(diǎn)擊的「address@example.com」鏈接。（這種作法雖然可以糊弄不少的機(jī)器人，但并不能全部擋下來，不過總比什么都不做好些。不管怎樣，公開你的信箱終究會(huì)引來廣告信件的。）

反斜杠

Markdown 可以利用反斜杠來插入一些在語(yǔ)法中有其它意義的符號(hào)，例如：如果你想要用星號(hào)加在文字旁邊的方式來做出強(qiáng)調(diào)效果（但不用 `` 標(biāo)簽），你可以在星號(hào)的前面加上反斜杠：? ? \*literal asterisks\*Markdown 支持以下這些符號(hào)前面加上反斜杠來幫助插入普通的符號(hào)：? ? \? 反斜線? ? `? 反引號(hào)? ? *? 星號(hào)? ? _? 底線? ? {}? 花括號(hào)? ? []? 方括號(hào)? ? ()? 括弧? ? #? 井字號(hào)? ? +? 加號(hào)? ? -? 減號(hào)? ? .? 英文句點(diǎn)? ? !? 驚嘆號(hào)

感謝

感謝 [leafy7382][] 協(xié)助翻譯，[hlb][]、[Randylien][] 幫忙潤(rùn)稿，[ethantw][] 的[漢字標(biāo)準(zhǔn)格式?CSS Reset][]， [WM][] 回報(bào)文字錯(cuò)誤。[leafy7382]:https://twitter.com/#!/leafy7382[hlb]:http://iamhlb.com/[Randylien]:http://twitter.com/randylien[ethantw]:https://twitter.com/#!/ethantw[漢字標(biāo)準(zhǔn)格式?CSS Reset]:http://ethantw.net/projects/han/[WM]:http://kidwm.net/感謝 [fenprace][]，[addv][]。[fenprace]:https://github.com/fenprace[addv]:https://github.com/addv----------

Markdown 免費(fèi)編輯器

Windows 平臺(tái)* [MarkdownPad](http://markdownpad.com/)* [MarkPad](http://code52.org/DownmarkerWPF/)Linux 平臺(tái)* [ReText](http://sourceforge.net/p/retext/home/ReText/)Mac 平臺(tái)* [Mou](http://mouapp.com/)在線編輯器* [Markable.in](http://markable.in/)* [Dillinger.io](http://dillinger.io/)瀏覽器插件* [MaDe](https://chrome.google.com/webstore/detail/oknndfeeopgpibecfjljjfanledpbkog) (Chrome)高級(jí)應(yīng)用* [Sublime Text 2](http://www.sublimetext.com/2) + [MarkdownEditing](http://ttscoff.github.com/MarkdownEditing/) / [教程](http://lucifr.com/2012/07/12/markdownediting-for-sublime-text-2/)\*** 如有更好的 Markdown 免費(fèi)編輯器推薦，請(qǐng)到[這里反饋](https://gitcafe.com/riku/Markdown-Syntax-CN/tickets/1)，謝謝！