MarkdownPad 2的基本語法使用

基礎語法

標題

Markdown支持6種級別的標題，對應html標簽 h1 ~ h6

1.  
   # h1
2.  
   ## h2
3.  
   ### h3
4.  
   #### h4
5.  
   ##### h5
6.  
   ###### h6

以上標記效果如下：

h1

h2

h3

h4

h5

h6

二級標題自帶下划線，也可以只寫##，引入下划線

除此之外，Markdown還支持另外一種形式的標題展示形式，其類似於 Setext 標記語言的表現形式，使用下划線進行文本大小的控制

1.  
   這是一級標題
2.  
   ===
3.  
   這是二級標題
4.  
   ---

使用這種方式處理標題僅有兩種表現形式，即一級標題和二級標題。遺憾的是，簡書並不支持這種語法。因此，我們用一張圖來展示效果：

 

 

這種處理方式在Github的一些開源工程上面比較常見，顯而易見的缺點是：文字大小控制級別有限。

段落及區塊引用

需要記住的是，Markdown其實就是一種易於編寫的普通文本，只不過加入了部分渲染文本的標簽而已。其最終依然會轉換為html標簽，因此使用Markdown分段非常簡單，前后至少保留一個空行即可。

而另外一個比較常見的需求就是，我們可能希望對某段文字進行強調處理。Markdown提供了一個特殊符號>用於段首進行強調，被強調的文字部分將會高亮顯示

> 這段文字將被高亮顯示...

以上標記顯示效果如下：

這段文字將被高亮顯示...

插入鏈接或圖片

Markdown針對鏈接和圖片的處理也比較簡單，可以使用下面的語法進行標記

1.  
   [ 點擊跳轉至百度](http://www.baidu.com)
2.  
   

以上標記顯示效果如下：

 

圖片

 

注： 引用圖片和鏈接的唯一區別就是在最前方添加一個感嘆號。

列表

Markdown支持有序列表和無序列表兩種形式：

• 無序列表使用*或+或-標識，標識與內容之間必須有空格
• 有序列表使用數字加.標識，例如：1.

1.  
   * 黃瓜
2.  
   * 玉米
3.  
   * 茄子
4.  
    
5.  
   + 黃瓜
6.  
   + 玉米
7.  
   + 茄子
8.  
    
9.  
   - 黃瓜
10.  
    - 玉米
11.  
    - 茄子
12.  
     
13.  
    1. 黃瓜
14.  
    2. 玉米
15.  
    3. 茄子

以上標記顯示效果如下：

• 黃瓜
• 玉米
• 茄子

• 黃瓜
• 玉米
• 茄子

• 黃瓜
• 玉米
• 茄子

1. 黃瓜
2. 玉米
3. 茄子

注：這里比較有趣的地方是，對於有序列表，Markdown將只關注你的第一個項目的數字編號。例如：如果第一個項目編號是3，以此類推，第二個項目應該是4，最終將顯示為3、4、5。而如果你指定了第一個編號，后面的編號指定錯誤也沒有關系，Markdown將只在乎你的第一個項目編號。

使用列表的一些注意事項

如果在單一列表項中包含了多個段落，為了保證渲染正常，*與段落首字母之間必須保留四個空格

1.  
   * 段落一
2.  
    
3.  
   小段一
4.  
   * 段落二
5.  
    
6.  
   小段二

以上標記顯示效果如下：

• 段落一

  小段一

• 段落二

  小段二

另外，如果在列表中加入了區塊引用，區域引用標記符也需要縮進4個空格

1.  
   * 段落一
2.  
   > 區塊標記一
3.  
   * 段落二
4.  
   > 區塊標記二

• 段落一

  區塊標記一

• 段落二

  區塊標記二

注：記住一個原則，如果在和列表配合使用的時候出現了問題，就縮進一次，四個空格或者一個制表符代表一次縮進。如果一次縮進沒有解決問題，那就兩次。

分隔線

有時候，為了排版漂亮，可能會加入分隔線。Markdown加入分隔線非常簡單，使用下面任意一種形式都可以

1.  
   ***
2.  
   ---

---

---

產生分隔線的語法要求比較松，符號之間添加空格也可以。

強調

有時候，我們希望對某一部分文字進行強調，使用*或_包裹即可。使用單一符號標記的效果是斜體，使用兩個符號標記的效果是加粗

1.  
   *這里是斜體*
2.  
   _這里是斜體_
3.  
    
4.  
   **這里是加粗**
5.  
   __這里是加粗__

這里是斜體
這里是斜體

這里是加粗
這里是加粗

高級用法

插入代碼塊

Markdown在IT圈子里面比較流行的一個重要原因是，它能夠輕松漂亮地插入代碼。

方法是，使用反引號`進行包裹即可。如果是行內代碼引用，使用單個反引號進行包裹

這是一段var x = 3行內代碼

如果插入一整段代碼，需要至少使用兩個以上反引號進行包裹， 看效果：

1.  
   fun (x: Int, y: Int): Int {
2.  
   return x + y
3.  
   }

注：很多人不知道怎么輸入反引號。在英文模式下，找到鍵盤最左側esc鍵下面的第一個鍵點擊即可。

插入表格

表格是Markdown語法中比較復雜的一個，其語法如下：

1.  
   表頭 |條目一|條目二
2.  
   :---:|:---:|:---:
3.  
   項目 |項目一|項目二

以上標記顯示效果如下：

表頭	條目一	條目二
項目	項目一	項目二

注：三個短斜杠左右的冒號用於控制對齊方式，只放置左邊冒號表示文字居左，只放置右邊冒號表示文字居右，如果兩邊都放置冒號表示文字居中。

其它

特殊符號處理

Markdown使用反斜杠\插入語法中用到的特殊符號。在Markdown中，主要有以下幾種特殊符號需要處理：

1.  
   \ 反斜線
2.  
   ` 反引號
3.  
   * 星號
4.  
   _ 底線
5.  
   {} 花括號
6.  
   [] 方括號
7.  
   () 括弧
8.  
   # 井字號
9.  
   + 加號
10.  
    - 減號
11.  
    . 英文句點
12.  
    ! 驚嘆號

例如，如果你需要插入反斜杠，就連續輸入兩個反斜杠即可：\\ => \ 。

注：在內容中輸入以上特殊符號的時候一定要注意轉義，否則將導致內容顯示不全，甚至排版混亂。

如何給文字上色

使用Markdown的同學最郁悶的地方恐怕就是不能給文字添加顏色了。事實上，Markdown的最初目標就是為純寫作而生的。因此，它並沒有考慮文字顏色這一點。所以，單純使用Markdown設置文字顏色已經做不到了。但你可以這樣做：

1. 先用Markdown編輯完成
2. 導出為html，在需要上色的部分手動添加標簽<font color='#ff0000'></font>保存即可。

Markdown軟件推薦

如果你是一個Mac用戶，我推薦你使用開源的 MacDown：

Macdown

 

如果你願意花錢的話，一些收費產品其實更好。例如：Byword，Ulysses，Typora等等都很不錯。

日常使用，我就用Macdown。寫書，我就用Ulysses。

簡單總結

Markdown是一門比html更簡單的標記語言，其主要用於日常寫作。最終通過相應的編輯器或者腳本轉換成html用於頁面渲染。如果你是一個作家，或者是一個程序員，Markdown對你來說是一門必備的技能。掌握Markdown真的很簡單，如你所見，這篇文章使用了這么短的篇幅就已經將Markdown的語法全部介紹完了。

不過，由於Markdown基礎語法的限制，出現了一些針對Markdown語法的加強版本。它支持的語法特性更多，但這不是我們這篇文章的討論范圍。如果你希望快速掌握Markdown，很簡單，動起來吧！