摘要：目前來(lái)看，支持語(yǔ)法的編輯器有很多，包括很多網(wǎng)站例如簡(jiǎn)書(shū)也支持了的文字錄入。在第一行后指定編程語(yǔ)言，也可以不指定需要注意的是寫(xiě)代碼框的前一行最好為空白行，否則無(wú)法生成相應(yīng)的樣式使用鍵即可縮進(jìn)。

語(yǔ)法包含標(biāo)題 列表 圖片 鏈接 表格 代碼框 分割線 索引 超鏈接 注釋 轉(zhuǎn)義 字體 顏色

導(dǎo)語(yǔ)

Markdown 是一種輕量級(jí)的「標(biāo)記語(yǔ)言」，它的優(yōu)點(diǎn)很多，目前也被越來(lái)越多的寫(xiě)作愛(ài)好者，撰稿者廣泛使用。看到這里請(qǐng)不要被「標(biāo)記」、「語(yǔ)言」所迷惑，Markdown 的語(yǔ)法十分簡(jiǎn)單。常用的標(biāo)記符號(hào)也不超過(guò)十個(gè)，這種相對(duì)于更為復(fù)雜的 HTML 標(biāo)記語(yǔ)言來(lái)說(shuō)，Markdown 可謂是十分輕量的，學(xué)習(xí)成本也不需要太多，且一旦熟悉這種語(yǔ)法規(guī)則，會(huì)有一勞永逸的效果。

• 創(chuàng)始人 John Gruber 的 Markdown 語(yǔ)法說(shuō)明

• Markdown 中文版語(yǔ)法說(shuō)明

一、認(rèn)識(shí)Markdown

在剛才的導(dǎo)語(yǔ)里提到，Markdown 是一種用來(lái)寫(xiě)作的輕量級(jí)「標(biāo)記語(yǔ)言」，它用簡(jiǎn)潔的語(yǔ)法代替排版，而不像一般我們用的字處理軟件 Word 或 Pages 有大量的排版、字體設(shè)置。它使我們專(zhuān)心于碼字，用「標(biāo)記」語(yǔ)法，來(lái)代替常見(jiàn)的排版格式。例如此文從內(nèi)容到格式，甚至插圖，鍵盤(pán)就可以通通搞定了。目前來(lái)看，支持 Markdown 語(yǔ)法的編輯器有很多，包括很多網(wǎng)站（例如簡(jiǎn)書(shū)）也支持了 Markdown 的文字錄入。Markdown 從寫(xiě)作到完成，導(dǎo)出格式隨心所欲，你可以導(dǎo)出 HTML 格式的文件用來(lái)網(wǎng)站發(fā)布，也可以十分方便的導(dǎo)出 PDF 格式，這種格式寫(xiě)出的簡(jiǎn)歷更能得到 HR 的好感。甚至可以利用 CloudApp 這種云服務(wù)工具直接上傳至網(wǎng)頁(yè)用來(lái)分享你的文章，全球最大的輕博客平臺(tái) Tumblr，也支持 Mou 這類(lèi) Markdown 工具的直接上傳。

使用Markdown的優(yōu)點(diǎn)

• 專(zhuān)注你的文字內(nèi)容而不是排版樣式，安心寫(xiě)作
• 輕松的導(dǎo)出 HTML、PDF 和本身的 .md 文件。
• 純文本內(nèi)容，兼容所有的文本編輯器與字處理軟件。
• 隨時(shí)修改你的文章版本，不必像字處理軟件生成若干文件版本導(dǎo)致混亂。
• 可讀、直觀、學(xué)習(xí)成本低。

二、Markdown 語(yǔ)法

標(biāo)題

標(biāo)題是每篇文章都需要也是最常用的格式，在 Markdown 中，如果一段文字被定義為標(biāo)題，只要在這段文字前加 # 號(hào)即可。

一級(jí)標(biāo)題： #

二級(jí)標(biāo)題 ：##

三級(jí)標(biāo)題： ###

以此類(lèi)推，總共 六 級(jí)標(biāo)題，建議在 “ # ” 號(hào)后加一個(gè)空格，這是最標(biāo)準(zhǔn)的 Markdown 語(yǔ)法。

另一種標(biāo)題

  大標(biāo)題
  ===
  小標(biāo)題
  ---

列表

熟悉 HTML 的同學(xué)肯定知道有序列表與無(wú)序列表的區(qū)別，在 Markdown 下，列表的顯示只需要在文字前加上 - 或 * 即可變?yōu)闊o(wú)序列表，有序列表則直接在文字前加 1. 2. 3. 符號(hào)要和文字之間加上一個(gè)字符的空格。

  - 列表一
  - 列表二
  * 列表三
  * 列表四
  1. 列表五
  2. 列表六

生成樣式：

• 列表一
• 列表二
• 列表三
• 列表四

1. 列表五
2. 列表六

嵌套列表

- + * 可循環(huán)使用，但符號(hào)之后的空格不能少，符號(hào)之前的空格也不能少

  - 嵌套列表1
   + 嵌套列表2
   + 嵌套列表3
    - 嵌套列表4
     * 嵌套列表5
  - 嵌套列表6

生成樣式：

• 嵌套列表1
  • 嵌套列表2
  • 嵌套列表3
    • 嵌套列表4
      • 嵌套列表5
• 嵌套列表6

引用

如果你需要引用一小段別外的句子，那么就要用引用的格式

> 例如這樣
>> 引用中的引用
>>> 很多引用

生成樣式：

例如這樣

例如這樣

引用中的引用

很多引用

只需要在文本前加入 > 這種尖括號(hào)（大于號(hào)）即可

圖片與鏈接

插入鏈接與插入圖片的語(yǔ)法很像，區(qū)別在一個(gè) !號(hào)

圖片為：![Tooltips](URL)

鏈接為：[Tooltips](URL)

  [百度](http://www.baidu.com "百度一下")

Tooltips可省略

生成樣式：

百度

自動(dòng)鏈接

  
  <123456@qq.com>

生成樣式：

http://www.baidu.com

123456@qq.com

粗體與斜體

Markdown 的粗體和斜體也非常簡(jiǎn)單，用兩個(gè) * 包含一段文本就是粗體的語(yǔ)法，用一個(gè) * 包含一段文本就是斜體的語(yǔ)法。

例如：

**這里是粗體** *這里是斜體*

生成樣式：

這里是粗體 這里是斜體

表格

| Tables        | Are           | Cool  |
| ------------- |:-------------:| -----:|
| col 3 is      | right-aligned | $1600 |
| col 2 is      | centered      |   $12 |
| zebra stripes | are neat      |    $1 |

這種語(yǔ)法生成的表格如下：

表格設(shè)置表頭居中

|:--|--:| 其中冒號(hào)表示表格需要居中的方向

注：不同平臺(tái)的解釋器會(huì)有不同影響，比如:--: 有可能也會(huì)影響表格

代碼框

單行代碼：使用一個(gè) “`”， 將首尾包圍起來(lái)。位置在鍵盤(pán)ESC的下面一個(gè)鍵
多行代碼：使用三個(gè) ` 將首尾行包圍起來(lái)。在第一行后指定編程語(yǔ)言，也可以不指定

需要注意的是：寫(xiě)代碼框的前一行最好為空白行，否則無(wú)法生成相應(yīng)的樣式

使用 tab 鍵即可縮進(jìn)。

如：

 "這是一行代碼"
 

 ```這是一段代碼```
 

```java
       public void main(String[] args){
            System.out.println("Hello world!");
       }
```

生成樣式：

這是一行代碼

這是一段代碼

public void main(String[] args){
  System.out.println("Hello world!");
}

另一種段落代碼：每行文字前加4個(gè)空格或者1個(gè)Tab

val s = "hello Markdown"
println( s )
val s = "hello Markdown"
println( s )

注：在創(chuàng)建表格時(shí)不使用空格或者Tab做開(kāi)關(guān)，否則會(huì)解析成段落代碼

Markdown支持的語(yǔ)言

其它

分割線

在一行中用三個(gè)以上的星號(hào)(*)、減號(hào)(-)、下劃線(_)來(lái)建立一個(gè)分隔線

除空格外行內(nèi)不能有其他字符

(除第一個(gè)符號(hào)的左側(cè)最多添加三個(gè)空格外）三個(gè)相同符號(hào)兩側(cè)可以添加任意多個(gè)空格。

---
___
***

生成樣式：

索引超鏈

索引，1 可以是任意字符

  [百度][1]
  [1]：http://www.baidu.com/

百度

注釋

　轉(zhuǎn)義字符

Markdown中的轉(zhuǎn)義字符為，轉(zhuǎn)義的有：

段落縮進(jìn)(空格)

 或 
 或 
 或 
 

這是一句話(huà)?或?這是一句話(huà)

這是一句話(huà)?或?這是一句話(huà)

這是一句話(huà)?或?這是一句話(huà)

?這是一句話(huà)

字體、字號(hào)、顏色

  我是黑體字
  我是微軟雅黑
  我是華文彩云
  黑體
  null
  gray

我是黑體字
我是微軟雅黑
我是華文彩云
黑體
null
gray

使用總結(jié)：

1. Markdown 是一個(gè)學(xué)習(xí)成本低的技術(shù)。學(xué)會(huì)它你可以用它記錄任何數(shù)據(jù)
2. Markdown 支持html的標(biāo)簽，在記錄過(guò)程中，如果這些標(biāo)簽滿(mǎn)足不了你，你也可以使用html
3. 這些知識(shí)點(diǎn)不一定都會(huì)使用到，一般只要用到常用的幾個(gè)，如果忘記了可以再看看教程。