<< [訪問 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ǔ)上進行了繁體轉(zhuǎn)簡體工作速兔，并進行了適當?shù)臐櫳巍４宋臋n用 Markdown 語法編寫，你可以到這里[查看它的源文件][src1]〕萃茫「繁體中文版的原始文件可以[查看這里][src] 婆翔。」--By @[riku][t]**注：** 本項目托管于 [GitCafe][]上拓哟，請通過"派生"和"合并請求"來幫忙改進本項目。 [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 語法說明 (簡體中文版) / ([點擊查看快速入門](./basic.html))================* [概述](#overview) * [宗旨](#philosophy) * [兼容 HTML](#html) * [特殊字符自動轉(zhuǎn)換](#autoescape)* [區(qū)塊元素](#block) * [段落和換行](#p) * [標題](#header) * [區(qū)塊引用](#blockquote) * [列表](#list) * [代碼區(qū)塊](#precode) * [分隔線](#hr)* [區(qū)段元素](#span) * [鏈接](#link) * [強調(diào)](#em) * [代碼](#code) * [圖片](#img)* [其它](#misc) * [反斜杠](#backslash) * [自動鏈接](#autolink)* [感謝](#acknowledgement)*[Markdown 免費編輯器](#editor)* * *

概述

宗旨

Markdown 的目標是實現(xiàn)「易讀易寫」伶授《闲颍可讀性，無論如何糜烹，都是最重要的违诗。一份使用 Markdown 格式撰寫的文件應(yīng)該可以直接以純文本發(fā)布，并且看起來不會像是由許多標簽或是格式指令所構(gòu)成疮蹦。Markdown 語法受到一些既有 text-to-HTML 格式的影響诸迟，包括 [Setext] [1]、[atx] [2]愕乎、[Textile] [3]阵苇、[reStructuredText] [4]、[Grutatext] [5] 和 [EtText] [6]感论，而最大靈感來源其實是純文本電子郵件的格式绅项。? [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 的語法全由一些符號所組成比肄，這些符號經(jīng)過精挑細選快耿，其作用一目了然。比如：在文字兩旁加上星號芳绩，看起來就像\*強調(diào)\*掀亥。Markdown 的列表看起來，嗯妥色，就是列表搪花。Markdown 的區(qū)塊引用看起來就真的像是引用一段文字，就像你曾在電子郵件中見過的那樣。

兼容 HTML

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

`刨啸、``、`

`识脆、`

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

` 標簽。

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

這是一個普通段落宫蛆。

Foo

這是另一個普通段落。請注意偎球，在 HTML 區(qū)塊標簽間的 Markdown 格式語法將不會被處理洒扎。比如，你在 HTML 區(qū)塊內(nèi)使用 Markdown 樣式的`*強調(diào)*`會沒有效果衰絮。HTML 的區(qū)段（行內(nèi)）標簽如 ``、``磷醋、`` 可以在 Markdown 的段落猫牡、列表或是標題里隨意使用。依照個人習(xí)慣邓线，甚至可以不用 Markdown 格式淌友，而直接采用 HTML 標簽來格式化煌恢。舉例說明：如果比較喜歡 HTML 的 `` 或 `` 標簽，可以直接使用這些標簽震庭，而不用 Markdown 提供的鏈接或是圖像標簽語法瑰抵。和處在 HTML 區(qū)塊標簽間不同，Markdown 語法在 HTML 區(qū)段標簽間是有效的器联。

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

在 HTML 文件中二汛，有兩個字符需要特殊處理： `<` 和 `&` 。 `<` 符號用于起始標簽拨拓，`&` 符號則用于標記 HTML 實體肴颊，如果你只是想要顯示這些字符的原型，你必須要使用實體的形式渣磷，像是 `<` 和 `&`婿着。`&` 字符尤其讓網(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才能放到鏈接標簽的 `href` 屬性里形纺。不用說也知道這很容易忽略袜硫，這也可能是 HTML 標準檢驗所檢查到的錯誤中，數(shù)量最多的挡篓。Markdown 讓你可以自然地書寫字符婉陷，需要轉(zhuǎn)換的由它來處理好了。如果你使用的 `&` 字符是 HTML 字符實體的一部分官研，它會保留原狀秽澳，否則它會被轉(zhuǎn)換成 `&`;。所以你如果要在文檔中插入一個版權(quán)符號 `?`戏羽，你可以這樣寫：? ? ?Markdown 會保留它不動担神。而若你寫：? ? AT&TMarkdown 就會將它轉(zhuǎn)為：? ? AT&T類似的狀況也會發(fā)生在 `<` 符號上，因為 Markdown 允許 [兼容 HTML](#html) 始花，如果你是把 `<` 符號作為 HTML 標簽的定界符使用妄讯，那 Markdown 也不會對它做任何轉(zhuǎn)換，但是如果你寫：? ? 4 < 5Markdown 將會把它轉(zhuǎn)換為：? ? 4 < 5不過需要注意的是酷宵，code 范圍內(nèi)亥贸，不論是行內(nèi)還是區(qū)塊， `<` 和 `&` 兩個符號都*一定*會被轉(zhuǎn)換成 HTML 實體浇垦，這項特性讓你可以很容易地用 Markdown 寫 HTML code （和 HTML 相對而言炕置， HTML 語法中，你要把所有的 `<` 和 `&` 都轉(zhuǎn)換為 HTML 實體，才能在 HTML 文件里面寫出 HTML code朴摊。）* * *

區(qū)塊元素

段落和換行

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

` 標簽。如果你*確實*想要依賴 Markdown 來插入 `

` 標簽的話悲靴，在插入處先按入兩個以上的空格然后回車臭胜。的確，需要多費點事（多加空格）來產(chǎn)生 `

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

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

標題

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

區(qū)塊引用 Blockquotes

Markdown 標記區(qū)塊引用是使用類似 email 中用 `>` 的引用方式虎锚。如果你還熟悉在 email 信件中的引言部分，你就知道怎么在 Markdown 文件中建立一個區(qū)塊引用衩婚，那會看起來像是你自己先斷好行窜护，然后在每行的最前面加上 `>` ：? ? > 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 也允許你偷懶只在整個段落的第一行最前面加上 `>` ：? ? > 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 語法谅猾，包括標題柄慰、列表鳍悠、代碼區(qū)塊等：> ## 這是一個標題税娜。> > 1.? 這是第一行列表項坐搔。> 2.? 這是第二行列表項。> > 給出一些例子代碼：> >? ? return shell_exec("echo $input | $markdown_script");任何像樣的文本編輯器都能輕松地建立 email 型的引用敬矩。例如在 BBEdit 中概行，你可以選取文字后然后從選單中選擇*增加引用階層*。

列表

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

Bird

McHale

Parish

如果你的列表標記寫成：? ? 1.? Bird? ? 1.? McHale? ? 1.? Parish或甚至是：? ? 3. Bird? ? 1. McHale? ? 8. Parish你都會得到完全相同的 HTML 輸出涧卵。重點在于，你可以讓 Markdown 文件的列表數(shù)字和輸出的結(jié)果相同腹尖，或是你懶一點柳恐，你可以完全不用在意數(shù)字的正確性。如果你使用懶惰的寫法热幔，建議第一個項目最好還是從 1. 開始乐设，因為 Markdown 未來可能會支持有序列表的 start 屬性。列表項目標記通常是放在最左邊绎巨，但是其實也可以縮進近尚，最多 3 個空格，項目標記后面則一定要接著至少一個空格或制表符场勤。要讓列表看起來更漂亮戈锻，你可以把內(nè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.但是如果你懶，那也行：? ? *? 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.如果列表項目間用空行分開和媳，在輸出 HTML 時 Markdown 就會將項目內(nèi)容用 `

`

標簽包起來格遭，舉例來說：

*? Bird

*? Magic

會被轉(zhuǎn)換為：

Bird

Magic

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

Bird

Magic

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

代碼區(qū)塊

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

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

這是一個普通段落：

這是一個代碼區(qū)塊淋昭。

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

Here is an example of AppleScript:

tell application "Foo"

beep

end tell

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

? 2004 Foo Corporation

會被轉(zhuǎn)換為：

? 2004 Foo Corporation

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

分隔線

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

區(qū)段元素

鏈接

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

This linkhas no? ? title attribute.

如果你是要鏈接到同樣主機的資源冷离，你可以使用相對路徑：? ? See my [About](/about/) page for details.? *參考式*的鏈接是在鏈接文字的括號后面再接上另一個方括號吵冒，而在第二個方括號里面要填入用以辨識鏈接的標記：? ? This is [an example][id] reference-style link.你也可以選擇性地在兩個方括號中間加上一個空格：? ? This is [an example] [id] reference-style link.接著，在文件的任意處西剥，你可以把這個標記的鏈接內(nèi)容定義出來：? ? [id]: http://example.com/? "Optional Title Here"鏈接內(nèi)容定義的形式為：*? 方括號（前面可以選擇性地加上至多三個空格來縮進）痹栖，里面輸入鏈接文字*? 接著一個冒號*? 接著一個以上的空格或制表符*? 接著鏈接的網(wǎng)址*? 選擇性地接著 title 內(nèi)容，可以用單引號蔫耽、雙引號或是括弧包著下面這三種鏈接的定義都是相同：[foo]: http://example.com/? "Optional Title Here"[foo]: http://example.com/? 'Optional Title Here'[foo]: http://example.com/? (Optional Title Here)**請注意：**有一個已知的問題是 Markdown.pl 1.0.1 會忽略單引號包起來的鏈接 title结耀。鏈接網(wǎng)址也可以用尖括號包起來：? ? [id]:"Optional Title Here"你也可以把 title 屬性放到下一行留夜，也可以加一些縮進匙铡，若網(wǎng)址太長的話，這樣會比較好看：? ? [id]: http://example.com/longish/path/to/resource/here? ? ? ? "Optional Title Here"網(wǎng)址定義只有在產(chǎn)生鏈接的時候用到碍粥，并不會直接出現(xiàn)在文件之中鳖眼。鏈接辨別標簽可以有字母、數(shù)字嚼摩、空白和標點符號钦讳，但是并*不*區(qū)分大小寫，因此下面兩個鏈接是一樣的：[link text][a][link text][A]*隱式鏈接標記*功能讓你可以省略指定鏈接標記枕面，這種情形下愿卒，鏈接標記會視為等同于鏈接文字，要用隱式鏈接標記只要在鏈接文字后面加上一個空的方括號潮秘，如果你要讓 "Google" 鏈接到 google.com琼开，你可以簡化成：[Google][]然后定義鏈接內(nèi)容：[Google]: http://google.com/由于鏈接文字可能包含空白，所以這種簡化型的標記內(nèi)也許包含多個單詞：Visit [Daring Fireball][] for more information.然后接著定義鏈接：[Daring Fireball]: http://daringfireball.net/鏈接的定義可以放在文件中的任何一個地方枕荞，我比較偏好直接放在鏈接出現(xiàn)段落的后面柜候，你也可以把它放在文件最后面，就像是注解一樣躏精。下面是一個參考式鏈接的范例：? ? 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"上面兩種寫法都會產(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").參考式的鏈接其實重點不在于它比較好寫矗烛，而是它比較好讀辅柴，比較一下上面的范例，使用參考式的文章本身只有 81 個字符瞭吃，但是用行內(nèi)形式的卻會增加到 176 個字元碌嘀，如果是用純 HTML 格式來寫，會有 234 個字元虱而，在 HTML 格式中筏餐，標簽比文本還要多。使用 Markdown 的參考式鏈接牡拇，可以讓文件更像是瀏覽器最后產(chǎn)生的結(jié)果魁瞪，讓你可以把一些標記相關(guān)的元數(shù)據(jù)移到段落文字之外穆律，你就可以增加鏈接而不讓文章的閱讀感覺被打斷。

強調(diào)

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

代碼

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

Use theprintf()function.

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

There is a literal backtick (`) here.

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

A single backtick in a code span:`

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

在代碼區(qū)段內(nèi)，`&` 和尖括號**都**會被自動地轉(zhuǎn)成 HTML 實體滤淳，這使得插入 HTML 原始碼變得很容易梧喷，Markdown 會把下面這段：? ? 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è)計一個「自然」的語法來插入圖片是有一定難度的娇钱。Markdown 使用一種和鏈接很相似的語法來標記圖片伤柄，同樣也允許兩種樣式： *行內(nèi)式*和*參考式*。行內(nèi)式的圖片語法看起來像是：? ? ? ? 詳細敘述如下：*? 一個驚嘆號 `!`*? 接著一個方括號文搂，里面放上圖片的替代文字*? 接著一個普通括號适刀，里面放上圖片的網(wǎng)址，最后還可以用引號包住并加上? ? 選擇性的 'title' 文字煤蹭。參考式的圖片語法則長得像這樣：? ? ![Alt text][id]「id」是圖片參考的名稱笔喉，圖片參考的定義方式則和連結(jié)參考一樣：? ? [id]: url/to/image? "Optional title attribute"到目前為止， Markdown 還沒有辦法指定圖片的寬高硝皂，如果你需要的話常挚，你可以使用普通的 `` 標簽。* * *

其它

自動鏈接

Markdown 支持以比較簡短的自動鏈接形式來處理網(wǎng)址和電子郵件信箱稽物，只要是用尖括號包起來奄毡， Markdown 就會自動把它轉(zhuǎn)成鏈接。一般網(wǎng)址的鏈接文字就和鏈接地址一樣贝或，例如：Markdown 會轉(zhuǎn)為：http://example.com/郵址的自動鏈接也很類似吼过，只是 Markdown 會先做一個編碼轉(zhuǎn)換的過程锐秦，把文字字符轉(zhuǎn)成 16 進位碼的 HTML 實體，這樣的格式可以糊弄一些不好的郵址收集機器人盗忱，例如：Markdown 會轉(zhuǎn)成：address@exa

mple.com在瀏覽器里面酱床，這段字串（其實是 `address@example.com`）會變成一個可以點擊的「address@example.com」鏈接。（這種作法雖然可以糊弄不少的機器人趟佃，但并不能全部擋下來扇谣，不過總比什么都不做好些。不管怎樣闲昭，公開你的信箱終究會引來廣告信件的罐寨。）

反斜杠

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

感謝

感謝 [leafy7382][] 協(xié)助翻譯衩茸，[hlb][]、[Randylien][] 幫忙潤稿贮泞，[ethantw][] 的[漢字標準格式?CSS Reset][]， [WM][] 回報文字錯誤幔烛。[leafy7382]:https://twitter.com/#!/leafy7382[hlb]:http://iamhlb.com/[Randylien]:http://twitter.com/randylien[ethantw]:https://twitter.com/#!/ethantw[漢字標準格式?CSS Reset]:http://ethantw.net/projects/han/[WM]:http://kidwm.net/感謝 [fenprace][]啃擦，[addv][]。[fenprace]:https://github.com/fenprace[addv]:https://github.com/addv----------

Markdown 免費編輯器

Windows 平臺* [MarkdownPad](http://markdownpad.com/)* [MarkPad](http://code52.org/DownmarkerWPF/)Linux 平臺* [ReText](http://sourceforge.net/p/retext/home/ReText/)Mac 平臺* [Mou](http://mouapp.com/)在線編輯器* [Markable.in](http://markable.in/)* [Dillinger.io](http://dillinger.io/)瀏覽器插件* [MaDe](https://chrome.google.com/webstore/detail/oknndfeeopgpibecfjljjfanledpbkog) (Chrome)高級應(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 免費編輯器推薦饿悬，請到[這里反饋](https://gitcafe.com/riku/Markdown-Syntax-CN/tickets/1)令蛉，謝謝！