[轉]Markdown 文法手冊

標籤：

Markdown 是一種輕量級標記語言，能將文本換成有效XHTML(或者HTML)文檔，它的目標是實現易讀易寫，成為一種適用於網路的書寫語言。

Markdown 文法簡潔明了，易於掌握，所以用它來寫作是件既效率又舒服的事情。我們所熟知的和一些大型CMS，如Joomla!、Drupal等都能很好的支援Markdown。我是因為寫GitHub項目庫中的Readme才開始接觸Markdown。

Markdown 不是想要取代 HTML，甚至也沒有要和它相近，它的文法種類很少，只對應 HTML 標籤的一小部分。Markdown 的構想不是要使得 HTML 文檔更容易書寫。在我看來， HTML 已經很容易寫了。Markdown 的理念是，能讓文檔更容易讀、寫和隨意改。HTML 是一種發布的格式，Markdown 是一種書寫的格式。就這樣，Markdown 的格式文法只涵蓋純文字可以涵蓋的範圍。

Headers 標題：

#  H1##  H2###  H3####  H4#####  H5######  H6 另外，H1和H2還能用以下方式顯示：一級標題=== 二級標題---

Emphasis 文本強調：

*斜體* or _強調_**加粗** or __加粗__***粗斜體*** or ___粗斜體__ 但是，如果你的 * 和 _ 兩邊都有空白的話，它們就只會被當成普通的符號：這是一段* 文本強調 *的說明樣本。如果要在文字前後直接插入普通的星號或底線，你可以用反斜線（轉義符）：\*this text is surrounded by literal asterisks\*

Lists 列表：

Unordered 無序列表：* 無序列表* 子項* 子項 + 無序列表+ 子項+ 子項 - 無序列表- 子項- 子項 Ordered 有序列表：1. 第一行2. 第二行3. 第三行 1. 第一行- 第二行- 第三行 組合：* 產品介紹（子項無項目符號）    此時子項，要以一個定位字元或者4個空格縮排 * 產品特點    1. 特點1    - 特點2    - 特點3* 產品功能    1. 功能1    - 功能2    - 功能3 可有時我們會出現這樣的情況，首行內容是以日期或數字開頭：2013. 公司年度目標。為了避免也被轉化成有序列表，我們可以在"."前加上反斜線（轉義符）：2013\. 公司年度目標。

Links 串連（title為可選項）：

Inline-style 內嵌方式：[link text](https://www.google.com "title text") Reference-style 引用方式：[link text][id][id]: https://www.mozilla.org "title text" Relative reference to a repository file 引用隱藏檔：[link text](../path/file/readme.text "title text") 還能這樣使用：[link text][][link text]: http://www.reddit.com Email 郵件：<[email protected]>

Images 圖片：

Inline-style 內嵌方式： Reference-style 引用方式：![alt text][logo][logo]: https://github.com/adam-p/markdown-here/raw/master/src/common/images/icon48.png "title text"

Code and Syntax Highlighting 代碼和文法高亮：

標記一小段行內代碼：本文是一篇介紹`Markdown`的文法的文章 如果高亮的內容包含`號，可以這樣寫：`` `包裹起來` `` 文法高亮：```html    <div>Syntax Highlighting</div>``````css    body{font-size:12px}``` ```javascript    var s = "JavaScript syntax highlighting";    alert(s);``````php    <?php      echo "hello, world!";    ?>``````python    s = "Python syntax highlighting"    print s```

Block Code 代碼分組(代碼區塊)：

在該行開頭縮排4個空格或一個定位字元(tab) <strong>Blockquotes 引用：</strong>> Email-style angle brackets> are used for blockquotes.> > And, they can be nested.> #### Headers in blockquotes> * You can quote a list.> * Etc.

Hard Line Breaks 換行：

在一行的結尾處加上2個或2個以上的空格，也可以使用</br>標籤第一行文字，第二行文字

Horizontal Rules 水平分割線：

**** * *- - -

Escape character 轉義符(反斜線)：

Markdown 可以利用反斜線來插入一些在文法中有其它意義的符號，例如：如果你想要用星號加在文字旁邊的方式來做出強調效果，你可以在星號的前面加上反斜線：\*literal asterisks\*Markdown 支援以下這些符號前面加上反斜線來協助插入普通的符號：\反斜線  `反引號  *星號  _底線  {}花括弧  []方括弧  ()括弧  #井字型大小  +加號  -減號  .英文句 !驚嘆號

Additional 補充：

Markdown也支援傳統的HTML標籤。比如一個連結，你不太喜歡Markdown的寫法，也可以直接寫成<a href="http://www.baidu.com">百度</a>

Markdown官網：http://daringfireball.net/projects/markdown/
參考資料：http://markdown.tw/

Markdown線上編輯器：
Dillinger：http://dillinger.io/
Markdown Here：http://markdown-here.com/livedemo.html

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

轉自：http://www.bluesdream.com/blog/markdown-cheatsheet-syntax-manual.html

[轉]Markdown 文法手冊