# 簡單說說 MarkDown 語法

簡單說說 MarkDown 語法

MarkDown 語法是當下非常流行的文本標記語言，它語法簡便排版優美，深受有文字處理和排版需求的人士的喜愛。如當下各種博客也支持MarkDown語法編輯博客，著名的分布式系統社群 github 也用的MarkDown語法來讓用戶寫 readme 文件。可見MarkDown語法在當下的使用是非常多的。
我也是有時寫博客或筆記覺得應該用個好的文本排版和標記語言，發現MarkDown之后感覺很好，但使用過程中由於不熟感語法覺使用起來很蹩腳，特此在此整理一些常用的語法，足夠日常使用，順便和初學者共享。

先展示目錄

• 簡單說說 MarkDown 語法
  • 1.標題 ：Headers
• 我是1級標題 ---> <h1>標簽
  • 我是2級標題 ---> <h2>標簽
    • 我是3級標題 ---> <h3>標簽
      • • • 我是6級標題 ---> <h6>標簽
  • 2.文字斜體和加粗
  • 3.列表
    • 無序的列表
    • 有序的列表
    • 復選框列表
  • 4.圖片
  • 5.連接 Links
  • 6.引用：Blockquotes
  • 7.內聯代碼 inline code
  • 8.多行內聯代碼 Multi-line code
  • 9.加刪除線 Strikethrough
  • 10. 橫向分割線 Horizontal Rules
  • 11.腳注 Footnote
  • 12 MarkDown的標注
  • 13自動生成目錄 TOC
  • 14還有很多 數學常用的表格制圖

1.標題 ：Headers

Example：

# 我是1級標題 ---> <h1>標簽
## 我是2級標題 ---> <h2>標簽
### 我是3級標題 ---> <h3>標簽
···
###### 我是6級標題 ---> <h6>標簽

Result：

我是1級標題 ---> <h1>標簽

我是2級標題 ---> <h2>標簽

我是3級標題 ---> <h3>標簽

···

我是6級標題 ---> <h6>標簽

2.文字斜體和加粗

Example：

*這樣會是斜體*
_這樣也會是斜體（下划線）_

**這樣會是粗體**
__這樣也是粗體__

*當然 **粗體** 和 _斜體_ 是可以混合使用的*

快捷鍵

CMD + U 這個是underline命令就是添加下划線
CMD + I 這個是italic命令就是斜線
CMD + B 這個是bold命令就是加粗

Result：

這樣會是斜體
這樣也會是斜體

這樣會是粗體
這樣也是粗體

*當然 粗體 和 斜體 是可以混合使用的*

3.列表

語法：* + 空格 或者數組+點+空格

無序的列表

Example：

* 我是第1條
* 我是第2條
* 我是第3條
* 我是第4條

Resule：

• 我是第1條
• 我是第2條
• 我是第3條
• 我是第4條

有序的列表

以上是無序的，以下是有順序的列表

Example：（有序的，如果有子項也是一樣tab+序號+.+空格）

1. 我是第1條
    1. 我是第1條的第1條子項
    2. 我是第1條的第2條子項
2. 我是第2條
3. 我是第3條
    1. 我是第3條的第1條子項
        1. 我是第3條的第1條子項的子項
        2. 我是第3條的第2條子項的子項
    2. 我是第3條的第2條子項
4. 我是第4條

Resule：

1. 我是第1條
   1. 我是第1條的第1條子項
   2. 我是第1條的第2條子項
2. 我是第2條
3. 我是第3條
   1. 我是第3條的第1條子項
      1. 我是第3條的第1條子項的子項
      2. 我是第3條的第2條子項的子項
   2. 我是第3條的第2條子項
4. 我是第4條

復選框列表

Example：

- [ ] 這是未選中的復選框` ‘-’ + ‘空格’ + ‘[中間有空格]’ `
- [x] 這是選中的復選框` ‘-’ + ‘空格’ + ‘[中間有空格]’ `

Result：

• 這是未選中的復選框‘-’ + ‘空格’ + ‘[中間有空格]’
• 這是選中的復選框‘-’ + ‘空格’ + ‘[中間有空格]’

4.圖片

Example：

![GitHub set up](https://help.github.com/assets/images/site/set-up-git.gif)
格式: ![Alt Text](url)

Result：

格式: ![Alt Text](url)

快捷鍵: Control + Shift + I

由於我使用的是MWeb這款軟件里面可以用 -w + Number 來控制圖片的寬度, 舉個例子，我們把這個圖片寬度限制為 140px:

5.連接 Links

Example:

郵箱、網址和自由鏈接的 三種格式：

email <[e-mail]>
[GitHub](http://github.com)
autolink  <http://www.github.com/>

快捷鍵: Control + Shift + L

Result:

一個 email [e-mail] 樣式的鏈接.
GitHub簡單網址樣式的鏈接
自動的網址樣式的鏈接
隨意的一個 URL (例如 http://www.github.com/) 將會自動轉換成一個可點擊的鏈接.

6.引用：Blockquotes

Example:

如曉友所說:
> 每天進步一點
> 好好生活，天天向上.

快捷鍵: 選中要變成引用的那句話按 CMD + Shift + B
格式： 格式就是 大於號 >
Result:

如曉友所說:

每天進步一點
好好生活，天天向上.

7.內聯代碼 inline code

Example:

有時候會使用到 小的單行的 代碼塊
`<addr>` `code` 如這種的.

快捷鍵: CMD + K
Result:

有時候會使用到 小的單行的 代碼塊
<addr> code 如這種的.

8.多行內聯代碼 Multi-line code

Example:

```js
function fancyAlert(arg) {
    if(arg) {
        $.facebox({div:'#foo'})
    }

}
```

快捷鍵: CMD + Shift + K
Result:

function fancyAlert(arg) {
    if(arg) {
        $.facebox({div:'#foo'})
    }

}

9.加刪除線 Strikethrough

Example:

(就像 這樣)

Result:

任何被兩個波浪線包裹的(比如 ~~這樣~~這樣)都會顯示出刪除線

10. 橫向分割線 Horizontal Rules

以下格式都會生成下划線

***

*****

- - -

Result:

---

---

---

11.腳注 Footnote

Example:

這就是一個腳注:[^sample_footnote]

Result:

這就是一個腳注:¹

12 MarkDown的標注

格式： <!-- comment -->
快捷鍵：CMD + .

13自動生成目錄 TOC

Example:

[TOC]

Result:

• 簡單說說 MarkDown 語法
  • 1.標題 ：Headers
• 我是1級標題 ---> <h1>標簽
  • 我是2級標題 ---> <h2>標簽
    • 我是3級標題 ---> <h3>標簽
      • • • 我是6級標題 ---> <h6>標簽
  • 2.文字斜體和加粗
  • 3.列表
    • 無序的列表
    • 有序的列表
    • 復選框列表
  • 4.圖片
  • 5.連接 Links
  • 6.引用：Blockquotes
  • 7.內聯代碼 inline code
  • 8.多行內聯代碼 Multi-line code
  • 9.加刪除線 Strikethrough
  • 10. 橫向分割線 Horizontal Rules
  • 11.腳注 Footnote
  • 12 MarkDown的標注
  • 13自動生成目錄 TOC
  • 14還有很多 數學常用的表格制圖

14還有很多 數學常用的表格制圖

由於這種我真的用的很少，沒有太多研究。以上都是常用的，希望對大家有幫助！

---

1. 這里就是上面腳注的那個注釋了 ↩