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

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

導(dǎo)語

Markdown 是一種輕量級的「標(biāo)記語言」，它的優(yōu)點(diǎn)很多，目前也被越來越多的寫作愛好者，撰稿者廣泛使用?？吹竭@里請不要被「標(biāo)記」、「語言」所迷惑，Markdown 的語法十分簡單。常用的標(biāo)記符號也不超過十個，這種相對于更為復(fù)雜的 HTML 標(biāo)記語言來說，Markdown 可謂是十分輕量的，學(xué)習(xí)成本也不需要太多，且一旦熟悉這種語法規(guī)則，會有一勞永逸的效果。

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

• Markdown 中文版語法說明

一、認(rèn)識Markdown

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

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

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

二、Markdown 語法

標(biāo)題

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

一級標(biāo)題： #

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

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

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

另一種標(biāo)題

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

列表

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

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

生成樣式：

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

1. 列表五
2. 列表六

嵌套列表

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

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

生成樣式：

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

引用

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

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

生成樣式：

例如這樣

例如這樣

引用中的引用

很多引用

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

圖片與鏈接

插入鏈接與插入圖片的語法很像，區(qū)別在一個 !號

圖片為：![Tooltips](URL)

鏈接為：[Tooltips](URL)

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

Tooltips可省略

生成樣式：

百度

自動鏈接

  
  <123456@qq.com>

生成樣式：

http://www.baidu.com

123456@qq.com

粗體與斜體

Markdown 的粗體和斜體也非常簡單，用兩個 * 包含一段文本就是粗體的語法，用一個 * 包含一段文本就是斜體的語法。

例如：

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

生成樣式：

這里是粗體 這里是斜體

表格

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

這種語法生成的表格如下：

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

|:--|--:| 其中冒號表示表格需要居中的方向

注：不同平臺的解釋器會有不同影響，比如:--: 有可能也會影響表格

代碼框

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

需要注意的是：寫代碼框的前一行最好為空白行，否則無法生成相應(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個空格或者1個Tab

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

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

Markdown支持的語言

其它

分割線

在一行中用三個以上的星號(*)、減號(-)、下劃線(_)來建立一個分隔線

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

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

---
___
***

生成樣式：

索引超鏈

索引，1 可以是任意字符

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

百度

注釋

　轉(zhuǎn)義字符

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

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

 或 
 或 
 或 
 

這是一句話?或?這是一句話

這是一句話?或?這是一句話

這是一句話?或?這是一句話

?這是一句話

字體、字號、顏色

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

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

使用總結(jié)：

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