# [X分鐘速成Y](http://learnxinyminutes.com/) ## 其中 Y=markdown 源代碼下載：?[learnmarkdown-cn.md](http://learnxinyminutes.com/docs/files/learnmarkdown-cn.md) Markdown 由 John Gruber 于 2004年創立. 它旨在成為一門容易讀寫的語法結構，并可以便利地轉換成 HTML（以及其他很多）格式。 歡迎您多多反饋以及分支和請求合并。 ~~~ <!-- Markdown 是 HTML 的父集，所以任何 HTML 文件都是有效的 Markdown。 這意味著我們可以在 Markdown 里使用任何 HTML 元素，比如注釋元素， 且不會被 Markdown 解析器所影響。不過如果你在 Markdown 文件內創建了 HTML 元素， 你將無法在 HTML 元素的內容中使用 Markdown 語法。--> <!-- 在不同的解析器中，Markdown 的實現方法有所不同。 此教程會指出當某功能是否通用及是否只對某一解析器有效。 --> <!-- 標頭 --> <!-- 通過在文本前加上不同數量的hash(#), 你可以創建相對應的 <h1> 到 <h6> HTML元素。--> # 這是一個 <h1> ## 這是一個 <h2> ### 這是一個 <h3> #### 這是一個 <h4> ##### 這是一個 <h5> ###### 這是一個 <h6> <!-- 對于 <h1> 和 <h2> 元素，Markdown 額外提供了兩種添加方式。 --> 這是一個 h1 ============= 這是一個 h2 ------------- <!-- 簡易文本樣式 --> <!-- 文本的斜體，粗體，和刪除線在 Markdown 中可以輕易地被實現。--> *此文本為斜體。* _此文本也是。_ **此文本為粗體。** __此文本也是__ ***此文本是斜體加粗體。*** **_或者這樣。_** *__這個也是！__* <!-- 在 Github 采用的 Markdown 中 --> ~~此文本為刪除線效果。~~ <!-- 單個段落由一句或多句鄰近的句子組成，這些句子由一個或多個空格分隔。--> 這是第一段落. 這句話在同一個段落里，好玩么？ 現在我是第二段落。 這句話也在第二段落！ 這句話在第三段落！ <!-- 如果你插入一個 HTML中的<br />標簽，你可以在段末加入兩個以上的空格， 然后另起一段。--> 此段落結尾有兩個空格（選中以顯示）。 上文有一個 <br /> ！ <!-- 段落引用可由 > 字符輕松實現。--> > 這是一個段落引用. 你可以 > 手動斷開你的句子，然后在每句句子前面添加 “>” 字符。或者讓你的句子變得很長，以至于他們自動得斷開。 > 只要你的文字以“>” 字符開頭，兩種方式無異。 > 你也對文本進行 >> 多層引用 > 這多機智啊！ <!-- 序列 --> <!-- 無序序列可由星號，加號或者減號來建立 --> * 項目 * 項目 * 另一個項目 或者 + 項目 + 項目 + 另一個項目 或者 - 項目 - 項目 - 最后一個項目 <!-- 有序序列可由數字加點來實現 --> 1. 項目一 2. 項目二 3. 項目三 <!-- 即使你的標簽數字有誤，Markdown 依舊會呈現出正確的序號， 不過這并不是一個好主意--> 1. 項目一 1. 項目二 1. 項目三 <!-- (此段與前例一模一樣) --> <!-- 你也可以使用子序列 --> 1. 項目一 2. 項目二 3. 項目三 * 子項目 * 子項目 4. 項目四 <!-- 代碼段落 --> <!-- 代碼段落（HTML中 <code>標簽）可以由縮進四格（spaces） 或者一個制表符（tab）實現--> This is code So is this <!-- 在你的代碼中，你仍然使用tab可以進行縮進操作 --> my_array.each do |item| puts item end <!-- 內聯代碼可由反引號 ` 實現 --> John 甚至不知道 `go_to()` 方程是干嘛的! <!-- 在Github的 Markdown中，對于代碼你可以使用特殊的語法 --> \`\`\`ruby <!-- 插入時記得移除反斜線， 僅留```ruby ！ --> def foobar puts "Hello world!" end \`\`\` <!-- 這里也是，移除反斜線，僅留 ``` --> <!-- 以上代碼不需要縮進，而且 Github 會根據```后表明的語言來進行語法高亮 --> <!-- 水平線 （<hr />） --> <!-- 水平線可由三個或以上的星號或者減號創建，可帶可不帶空格。 --> *** --- - - - **************** <!-- 鏈接 --> <!-- Markdown 最棒的地方就是簡易的鏈接制作。鏈接文字放在中括號[]內， 在隨后的括弧()內加入url。--> [點我點我!](http://test.com/) <!-- 你也可以為鏈接加入一個標題：在括弧內使用引號 --> [點我點我!](http://test.com/ "連接到Test.com") <!-- 相對路徑也可以有 --> [去 music](/music/). <!-- Markdown同樣支持引用樣式的鏈接 --> [點此鏈接][link1]以獲取更多信息！ [看一看這個鏈接][foobar] 如果你愿意的話. <!-- 鏈接的標題可以處于單引號中，括弧中或是被忽略。引用名可以在文檔的任意何處， 并且可以隨意命名，只要名稱不重復。--> <!-- “隱含式命名” 的功能可以讓鏈接文字作為引用名 --> [This][] is a link. <!-- 但這并不常用 --> <!-- 圖像 --> <!-- 圖像與鏈接相似，只需在前添加一個感嘆號 -->  <!-- 引用樣式也同樣起作用 --> ![這是我的懸停文本.][myimage] <!-- 雜項 --> <!-- 自動鏈接 --> <http://testwebsite.com/> 與 [http://testwebsite.com/](http://testwebsite.com/) 等同 <!-- 電子郵件的自動鏈接 --> <foo@bar.com> <!-- 轉義字符 --> 我希望 *將這段文字置于星號之間* 但是我不希望它被 斜體化, 所以我就: \*這段置文字于星號之間\*。 <!-- 表格 --> <!-- 表格只被 Github 的 Markdown 支持，并且有一點笨重，但如果你真的要用的話: --> | 第一列 | 第二列 | 第三列 | | :---------- | :------: | ----------: | | 左對齊 | 居個中 | 右對齊 | | 某某某 | 某某某 | 某某某 | <!-- 或者, 同樣的 --> 第一列 | 第二列 | 第三列 :-- | :-: | --: 這太丑了 | 藥不能 | 停 <!-- 結束! --> ~~~ 更多信息, 請于[此處](http://daringfireball.net/projects/Markdown/syntax)參見 John Gruber 關于語法的官方帖子，及于[此處](https://github.com/adam-p/Markdown-here/wiki/Markdown-Cheatsheet)?參見 Adam Pritchard 的摘要筆記。