5分鐘，帶你迅速上手Markdown語法

級別： ★☆☆☆☆
標籤：「通用技能」「Markdown」
做者： MrLiuQ
審校： QiShare團隊

---

前言：本篇將重點講解：Markdown的 「語法規範」 與 「上手指南」 。

---

1、Markdown簡介

Markdown是一種文本標記語言，它容易上手、易於學習，排版清晰明瞭、直觀清晰。經常使用於撰寫 「技術文檔」 、 「技術博客」 、 「開發文檔」 等等。 總之，若是你是一名開發者，而且你有寫博客的慾望與想法時，使用Markdown是你不二的選擇。

---

2、Markdown語法

接下來，咱們來看一下Markdown的 「標準語法」 。

咱們看下大綱，其中包括：

一、標題

• 標準語法：使用1~6個「#」符 + 「空格」 + 「你的標題」。

# 一級標題
## 二級標題
### 三級標題
#### 四級標題
##### 五級標題
###### 六級標題 
複製代碼

• 效果圖解：

注：#和「標題」之間有一個空格，這是最標準的語法格式。 有些編輯器作了兼容，有的並無。因此最好要加上空格。

二、列表

• 標準語法：使用-符，在文本前加入-符便可。

- 文本1
- 文本2
- 文本3
複製代碼

若是你但願有序，在文本前加上1.、2.、3.、4.、...

1. 文本1
2. 文本2
3. 文本3
複製代碼

注：-、1.、2.等和文本之間要保留一個字符的空格。

• 效果圖解：

三、超連接

• 標準語法：[連接名](連接url)

• 效果圖解：

四、圖片

• 標準語法：

![圖片名](連接url)
複製代碼

• 效果圖解：

五、引用

• 標準語法：> 文本

• 效果圖解：

六、斜體、加粗

• 標準語法 斜體：*文本* 加粗：**文本** 斜體&加粗：***文本***

• 效果圖解：

七、代碼塊

• 標準語法： ``` 你的代碼 ```（前面3個點，後面3個點）

• 效果圖解：

---

八、表格

• 標準語法：

dog | bird | cat
----|------|----
foo | foo  | foo
bar | bar  | bar
baz | baz  | baz
複製代碼

• 效果圖解：

---

九、特殊標記

• 標準語法：``

`特殊樣式`
複製代碼

• 效果圖解：

---

十、分割線

• 標準語法：--- 最少3個

• 效果圖解：

十一、經常使用html標記

注意：html標記只適合輔助使用，不必定全部編輯器都能生效。

• 標準語法：

換行符：<br/> （或者使用Markdown標準語法：空格+空格+回車，但我感受不是很直觀）
上：<sup>文本</sup>
下：<sub>文本</sub>

• 效果圖解：

---

3、Markdown優勢

• 純文本，因此兼容性極強，能夠用全部文本編輯器打開。
• 讓做者更專一於寫做而不是排版。（你們都是技術人員嘛..）
• 格式轉化方便，markdown文本能夠很輕鬆轉成html、pdf等等。（圖個方便嘛）
• 語法簡單
• 可讀性強，配合表格、引用、代碼塊等等，讓讀者瞬間「懂你」。

---

小編微信：可加並拉入《QiShare技術交流羣》。

關注咱們的途徑有：
QiShare(簡書)
QiShare(掘金)
QiShare(知乎)
QiShare(GitHub)
QiShare(CocoaChina)
QiShare(StackOverflow)
QiShare(微信公衆號)

推薦文章：
Swift 5.1 (2) - 運算符
Swift 5.1(1) - 基礎
iOS UI狀態保存和恢復（三）
iOS UI狀態保存和恢復（二）
iOS UI狀態保存和恢復（一）
iOS 中精肯定時的經常使用方法
Sign In With Apple（一）
奇舞週刊