Markdown 語法快速入門手冊

• Markdown 是一種輕量級標記語言，能將文本換成有效的 XHTML(或者 HTML)文檔，它的目標是實現(xiàn)易讀易寫，成為一種適用于網(wǎng)絡的書寫語言。
  
• Markdown 語法簡潔明了，易于掌握，所以用它來寫作是件既效率又舒服的事情。我們所熟知的和一些大型 CMS，如 Joomla!、Drupal 等都能很好的支持 Markdown。我是因為寫GitHub項目庫中的 Readme 才開始接觸 Markdown。
  
• Markdown 不是想要取代 HTML，甚至也沒有要和它相近，它的語法種類很少，只對應 HTML 標記的一小部分。
  
• Markdown 的構想不是要使得 HTML 文檔更容易書寫。在我看來， HTML 已經(jīng)很容易寫了。
  
• Markdown 的理念是，能讓文檔更容易讀、寫和隨意改。
  
• HTML 是一種發(fā)布的格式，Markdown 是一種書寫的格式。
  
• 就這樣，Markdown 的格式語法只涵蓋純文本可以涵蓋的范圍。
  

Headers 標題：

#  H1
##  H2
###  H3
####  H4
#####  H5
######  H6

另外，H1 和 H2 還能用以下方式顯示：

一級標題
===
 
二級標題
---

Emphasis 文本強調(diào)：

*斜體* or _強調(diào)_
**加粗** or __加粗__
***粗斜體*** or ___粗斜體__

但是，如果你的*和_兩邊都有空白的話，它們就只會被當成普通的符號：這是一段*文本強調(diào)*的說明示例。

如果要在文字前后直接插入普通的星號或底線，你可以用反斜線（轉(zhuǎn)義符）：\*這是一段被星號包圍的文字\*

Lists 列表：

Unordered 無序列表：

* 無序列表
* 子項
* 子項
 
+ 無序列表
+ 子項
+ 子項
 
- 無序列表
- 子項
- 子項

Ordered 有序列表：

1. 第一行
2. 第二行
3. 第三行
 
1. 第一行
- 第二行
- 第三行

組合：

* 產(chǎn)品介紹（子項無項目符號）
    此時子項，要以一個制表符或者4個空格縮進
 
* 產(chǎn)品特點
    1. 特點1
    - 特點2
    - 特點3
* 產(chǎn)品功能
    1. 功能1
    - 功能2
    - 功能3
 

可有時我們會出現(xiàn)這樣的情況，首行內(nèi)容是以日期或數(shù)字開頭：2017. 公司年度目標。

為了避免也被轉(zhuǎn)化成有序列表，我們可以在"."前加上反斜杠（轉(zhuǎn)義符）：2017\. 公司年度目標。

Links 連接（title為可選項）：

Inline-style 內(nèi)嵌方式：

[W3Cschool](http://m.hgci.cn/ "W3Cschool")

Reference-style 引用方式：

[鏈接文字][id]
[id]: http://m.hgci.cn/ "標題文字"

Relative reference to a repository file 引用存儲文件：

[鏈接文字](../path/file/readme.text "標題文字")

還能這樣使用：

[鏈接文字][]
[鏈接文字]: http://m.hgci.cn/

Email 郵件：

<example@w3cschool.cn>

Images 圖片：

Inline-style 內(nèi)嵌方式：

![替代文字](http://statics.w3cschool.cn/images/w3c/index-logo.png "標題文字")

Reference-style 引用方式：

![替代文字][logo]
[logo]: http://statics.w3cschool.cn/images/w3c/index-logo.png "標題文字"

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

標記一小段行內(nèi)代碼：

本文是一篇介紹`Markdown`的語法的文章

如果高亮的內(nèi)容包含`號，可以這樣寫：

`` `包裹起來` ``

語法高亮：

```html
    <div>語法高亮顯示</div>
```

```css
    body{font-size:12px}
```

```javascript
    var s = "JavaScript語法高亮顯示";
    alert(s);
```

```php
    <?php
      echo "你好，編程獅!";
    ?>
```

```python
    s = "Python 語法高亮"
    print s
```

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

在該行開頭縮進4個空格或一個制表符(tab)

Blockquotes 引用：

> 電子郵件風格尖括號
> 用于區(qū)塊報價。
> > 而且，它們可以嵌套。
> #### 區(qū)塊引號中的標題
> * 你可以引用一個列表。
> * 等等。

Hard Line Breaks 換行：

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

Horizontal Rules 水平分割線：

***
* * *
- - -

Escape character 轉(zhuǎn)義符(反斜杠)：

Markdown 可以利用反斜杠來插入一些在語法中有其它意義的符號，例如：如果你想要用星號加在文字旁邊的方式來做出強調(diào)效果，你可以在星號的前面加上反斜杠：

\*字面星號\*

Markdown 支持以下這些符號前面加上反斜杠來幫助插入普通的符號：

\反斜杠  
`反引號  
*星號  
_下劃線  
{}花括號  
[]方括號  
()括弧  
#井字號  
+加號  
-減號  
.英文句 
!感嘆號

Additional 補充：

Markdown 也支持傳統(tǒng)的 HTML 標簽。

比如一個鏈接，你不太喜歡 Markdown 的寫法，也可以直接寫成

<a href="http://m.hgci.cn/">W3Cschool</a>

• Markdown官網(wǎng)：http://daringfireball.net/projects/markdown/
• 參考資料：http://markdown.tw/

Markdown在線編輯器：

• 在線Markdown編譯器：http://m.hgci.cn/tools/index?name=markdown

• 在線Markdown編輯器：http://m.hgci.cn/tools/index?name=editormd

• Dillinger：http://dillinger.io/
  
• Markdown Here：http://markdown-here.com/livedemo.html