MarkDown基本語法使用教程

Markdwon 是一種輕量級 標記語言，它以純文本形式（易讀、易寫、易更改）編寫文檔，並最終以HTLM格式發佈。Markdown也可以理解爲將以 MARKDOWN語法編寫的語言轉換成HTML內容的工具

1.標題

在想要設置爲標題的文字前面加#來表示，markdown最多支持六級標題

md語法

# 一級標題
## 二級標題
### 三級標題
#### 四級標題
##### 五級標題
###### 六級標題

效果

---

2.字體樣式

加粗的文字左右分別用兩個*號或_包起來
要傾斜的文字左右分別用一個*號或_包包起來
要傾斜和加粗的文字左右分別用三個*號或_包包起來
要加刪除線的文字左右分別用兩個~~號包起來

md語法

斜體
*斜體內容*
_斜體內容_
加粗
**加粗內容**
__加粗內容__
斜體+加粗
***斜體加粗內容***
___斜體加粗內容___
刪除線
~~刪除線內容~~

效果
斜體
斜體內容
斜體內容
加粗
加粗內容
加粗內容
斜體+加粗
斜體加粗內容
斜體加粗內容
刪除線
刪除線內容

---

3.引用

在引用的文字前加>，引用也可以嵌套，markdown支持無限級的引用，一般只用一級引用
md語法

> 引用一
>> 引用二
>>> 引用三

效果

引用一

引用二

引用三

---

4.分割線

分割線使用三個或三個以上的 - 或 * 進行分割
md語法

---
----
***
****

效果

---

---

---

---

5.插入圖片

md語法

![alt內容](圖片url ''圖片標題'')

alt內容：顯示在圖片下面的文字，相當於對圖片內容的解釋，有些md編輯器不支持。
圖片URL：圖片的地址，可以使本地地址，也可以是網絡圖片的地址
圖片標題：當鼠標移到圖片上時顯示的內容。標題可加可不加

示例

![提示內容](https://imgconvert.csdnimg.cn/aHR0cHM6Ly93d3cuYmFpZHUuY29tL2ltZy9iZF9sb2dvMS5wbmc "圖片標題")

效果

---

6.超鏈接

md語法

[超鏈接名稱](超鏈接地址 "超鏈接標題")
或
<超鏈接地址>

超鏈接名稱：顯示出來的文字。
超鏈接地址：需要跳轉的超鏈接地址
超鏈接標題：當鼠標移到超鏈接上時顯示的內容。標題可加可不加

示例

[超鏈接名稱](http://baidu.com "超鏈接標題")
<http://baidu.com>

效果
超鏈接名稱
http://baidu.com

---

7.列表

• 有序列表
  數字加點，序號跟內容之間要有空格。有序列表和無序列表都可以嵌套使用。
  md語法

1. 有序列表
2. 有序列表
3. 有序列表

效果

1. 有序列表
2. 有序列表
3. 有序列表

• 無序列表
  用 - + * 任何一種都可以，- + * 跟內容之間都要有一個空格
  md語法

+ 無序列表
- 無序列表
* 無序列表

效果

• 無序列表

• 無序列表

• 無序列表

• 任務列表
  md語法

- [ ] 計劃任務1
- [ ] 計劃任務2
- [x] 完成任務3
- [x] 完成任務4

效果

• 計劃任務1
• 計劃任務2
• 完成任務3
• 完成任務4

---

8.表格

md語法

表頭|表頭|表頭
:--|--:|:--:
左對齊|居右對齊|中間對齊
內容|內容|內容

第一行是表格的標題，決定表格的列數，表頭與表頭用 | 隔開
第二行用來分割表頭和內容，表格內容左對齊,則在"--"前加“:”，
	如果需要右對齊，則在"--"後加“:”，居中則在“--”兩邊都加“:”

效果

表頭	表頭	表頭
左對齊	居右對齊	中間對齊
內容	內容	內容

---

9.代碼

md語法

單行代碼：
`代碼內容`

多行代碼：
(```) 去掉括號
	代碼區
(```) 去掉括號

效果
單行代碼：
代碼內容

多行代碼：

	代
	碼
	區

---

10.轉義

和其他編程語言類似，Markdown 使用了很多特殊符號來表示特定的意義，如果需要顯示特定的符號則需要使用轉義字符，Markdown 使用反斜槓轉義特殊字符"\"。
Markdown 支持以下這些符號前面加上反斜槓來幫助插入普通的符號：
md語法

\   反斜線
`   反引號
*   星號
_   下劃線
{}  花括號
[]  方括號
()  小括號
#   井字號
+   加號
-   減號
.   英文句點
!   感嘆號

示例

\*\*正常文本帶星號\*\*
\\   反斜線
\`   反引號
\*   星號
\_   下劃線
\{\}  花括號
\[\]  方括號
\(\)  小括號
\#   井字號
\+   加號
\-   減號
\.   英文句點
\!   感嘆號

效果
**正常文本帶星號**
\ 反斜線
` 反引號
* 星號
_ 下劃線
{} 花括號
[] 方括號
() 小括號
# 井字號
+ 加號
- 減號
. 英文句點
! 感嘆號

---

11.支持HTML

不在 Markdown 涵蓋範圍之內的標籤，都可以直接在文檔裏面用 HTML 撰寫。
目前支持的 HTML 元素有：<kbd> <b> <i> <em> <sup> <sub> <br>等。
md語法

<kbd>Ctrl</kbd>    表示按鍵Ctrl
<b>內容</b>    內容加粗
<i>內容</i>    內容傾斜
<em>內容</em>    內容強調
ABC<sup>內容</sup>   內容上標
ABC<sub>內容</sub>   內容下標

效果
Ctrl 表示按鍵Ctrl
內容 內容加粗
內容 內容傾斜
內容 內容強調
ABC^內容 內容上標
ABC_內容 內容下標

---

12.流程圖、甘特圖、UML圖

MarkDown支持多種例如流程圖、甘特圖、UML圖的繪製，圖設計內容比較多，會在另外的文章裏面詳細說明。
MarkDown流程圖可以使用mermaid流程圖，也可以使用flow流程圖。
這裏只給出兩種流程圖的簡單使用示例。

1.使用mermaid製作流程圖

md語法

```mermaid
	graph TB
	start(開始) -->  in[輸入分數Score]
	in --> judg{Score > 100}
	judg --否-->err[分數不合法]
	judg --是-->judg80{Score >= 80}
	judg80 --是-->out80[優秀]
	judg80 --否--> judg60{Score >= 60}
	judg60 --是--> out60[中等]
	judg60 --否-->out0[差]
	out80 --> out[輸出等級]
	out60 --> out[輸出等級]
	out0 --> out[輸出等級]
	out --> stop(結束)
	err -->stop
$```(使用時去掉$)

效果

2.使用flow製作流程圖
md語法

注意：1.“:”後需要有一個空格   2.“=>”和"->"前後都不能有空格
```$flow
st=>start: 開始
in=>operation: 輸入分數Score
judg=>condition: Score > 100
err=>operation: 分數不合法
judg80=>condition: Score >= 80
out80=>operation: 優秀
judg60=>condition: Score >= 60
out60=>operation: 中等
out0=>operation: 差
out=>operation: 輸出等級
ed=>end: 結束

st->in->judg
judg(yes)->judg80
judg(no)->err->ed
judg80(yes)->out80->out
judg80(no)->judg60->out
judg60(yes)->out60->out
judg60(no)->out0->out
out->ed
	
$```(使用時去掉所有$)

效果

在某些markdown編譯其中，會將flow流程圖轉換成mermaid流程圖，上面的流程圖轉換成mermaid的流程圖代碼如下：

```mermaid
flowchat
st=>start: 開始
in=>operation: 輸入分數Score
judg=>condition: Score > 100
err=>operation: 分數不合法
judg80=>condition: Score >= 80
out80=>operation: 優秀
judg60=>condition: Score >= 60
out60=>operation: 中等
out0=>operation: 差
out=>operation: 輸出等級
ed=>end: 結束

st->in->judg
judg(yes)->judg80
judg(no)->err->ed
judg80(yes)->out80->out
judg80(no)->judg60->out
judg60(yes)->out60->out
judg60(no)->out0->out
out->ed
$```(使用時去掉$)

---

13.數學公式

當需要在編輯器中插入數學公式時，可以使用一個或兩個美元符 $ 包裹 TeX 或 LaTeX 格式的數學公式來實現。
此處涉及的LaTex公式會通過另外一篇文章講解，在這裏用一個示例簡單試用一下。
md語法

範德蒙行列式：

$$|A|  = \left[\begin{matrix} 1&1&\cdots&1 \\  
a_1&a_2&\cdots&a_n \\  
\vdots&\vdots&\vdots&\vdots \\  
a_1^{n-1}&a_2^{n-1}&\cdots&a_n^{n-1} \\
\end{matrix}\right] = \displaystyle \prod^{}_{j>i}(a_j-a_i)$$

效果
$|A| = \left[\begin{matrix} 1&1&\cdots&1 \\ a_1&a_2&\cdots&a_n \\ \vdots&\vdots&\vdots&\vdots \\ a_1^{n-1}&a_2^{n-1}&\cdots&a_n^{n-1} \\ \end{matrix}\right] = \displaystyle \prod^{}_{j>i}(a_j-a_i)$

---

14.目錄

md語法

@[TOC](目錄標題)

效果
見頁首

---

15.註解

註解通常用來批量解釋一些專業術語，專業短語等知識，使用註解後，將鼠標放到需要解釋的術語上，就可以看到我們的解釋內容。
需要注意的是，在內容中註釋的短語前後需要使用空格隔開。
md語法

自1990年以來，HTML就一直被用作WWW的信息表示語言，使用HTML語言描述的文件需要通過WWW瀏覽器顯示出效果。
HTML是一種建立網頁文件的語言，通過標記式的指令(Tag)，將影像、聲音、圖片、文字動畫、影視等內容顯示出來。
事實上，每一個HTML文檔都是一種靜態的網頁文件，這個文件裏面包含了HTML指令代碼。

*[HTML]: 超文本標記語言
*[WWW]: 萬維網

效果
自1990年以來，HTML 就一直被用作 WWW 的信息表示語言，使用 HTML 語言描述的文件需要通過 WWW 瀏覽器顯示出效果。
HTML 是一種建立網頁文件的語言，通過標記式的指令(Tag)，將影像、聲音、圖片、文字動畫、影視等內容顯示出來。
事實上，每一個 HTML 文檔都是一種靜態的網頁文件，這個文件裏面包含了 HTML 指令代碼。

16.腳註

爲了增加文檔的可讀性，時常會在文檔中添加一些腳註，腳註位於頁面的底部，可以作爲文檔某處內容的註釋。當我們使用鼠標點擊註腳編號時，頁面會自動跳轉自相應的腳註處。
md語法

超文本標記語言[^1]是標準通用標記語言下的一個應用[^2]，也是一種規範，一種標準

[^1]: 超文本標記語言,英文爲HTML，由Tim Berners-Lee發明
[^2]: 現代人常說的應用，一般指手機和平板電腦的應用。在面向對象上通常分爲個人用戶應用與企業級應用

效果
超文本標記語言¹是標準通用標記語言下的一個應用²，也是一種規範，一種標準

---

1. 超文本標記語言,英文爲HTML，由Tim Berners-Lee發明 ↩︎

2. 現代人常說的應用，一般指手機和平板電腦的應用。在面向對象上通常分爲個人用戶應用與企業級應用 ↩︎