MarkDown 基本語法
MarkDown 是一種純文本格式的標記語言,通過簡單的標記語法,可以使普通的文本具有一定的格式。它是將文檔以 HTML 格式發(fā)布,最終的顯示效果取決于前端的渲染。MarkDown 也可以理解為將以 MarkDown 語法編寫的純文本轉(zhuǎn)換成 HTML 的工具,最終在網(wǎng)頁顯示 HTML 內(nèi)容。
目錄
一、標題
使用 # 表示 1~6 級標題
標準語法是在 # 后跟一個空格,1 個 # 表示一級標題,2 個 ## 表示二級標題
# 一級標題
## 二級標題
### 三級標題
#### 四級標題
##### 五級標題
###### 六級標題
效果如下:
一級標題
二級標題
三級標題
四級標題
五級標題
六級標題
一級標題和二級標題還可以通過 === 和 --- 符號標記,標記方式如下:
一級標題
===
二級標題
---
效果如下:
一級標題
二級標題
二、目錄
目錄使用 [顯示文字](#段落中的標題) 的形式鏈接到當前文檔的特定位置,如下寫法可連接到本文檔的 九、列表 位置處,寫法如下
[鏈接到第九章](#九、列表)
效果如下
鏈接到第九章
三、段落
需要使用空行分段,即段落的前后需要是空行,只回車換行在顯示效果中是沒有換行效果的。
若想在一個段落內(nèi)換行,需要在行尾加上至少兩個空格,再回車換行。
若想在特定位置加入空行,可以在使用 <br> 表示空行,如下所示:
直接回車換行
不能實現(xiàn)換行功能
行末加兩個空格
實現(xiàn)換行
使用<br>表示換行<br><br>換兩行
效果如下:
直接回車換行
不能實現(xiàn)換行功能
行末加兩個空格
實現(xiàn)換行
使用
表示換行
換兩行
四、字體
-
粗體
使用**粗體文字**的形式,在要加粗的文字兩端使用兩個**包裹起來粗體文字
-
斜體
使用*斜體文字*的形式,在文字的兩端使用*包裹起來斜體文字
-
刪除線
使用~~刪除線文字~~的形式,在文字的兩端使用~~包裹起來刪除線文字
以上方式還可以組合使用,如下所示
***加粗的斜體文字***
~~*斜體帶刪除線文字*~~
~~**加粗帶刪除線文字**~~
~~***加粗的斜體帶刪除線文字***~~
效果如下
加粗的斜體文字
斜體帶刪除線文字
加粗帶刪除線文字
加粗的斜體帶刪除線文字
五、引用
引用在行首加 > 符號即可,還可嵌套引用,輸入多個 > 即可,如下所示
> 引用
>> 嵌套引用
>>> 多層嵌套引用
效果如下
引用
嵌套引用
多層嵌套引用
六、分割線
分割線使用三個或三個以上的 - 或 * 符號
---
***
效果如下
注意,在使用 --- 符號時,上一行應(yīng)當是空行,否則其會將上一行解釋為二級標題,而不是分割線
七、超鏈接
超鏈接使用 [超鏈接名](超鏈接地址 "超鏈接標題") 的語法,其中 "超鏈接標題" 可寫可不寫,其效果為鼠標懸停時顯示的文字
[百度](https://www.baidu.com "百度網(wǎng)址")
效果為
百度
八、圖片
插入圖片的語法和插入超鏈接類似,只需在鏈接前面加上 ! 即可,語法如下

其中圖片地址可以是本地路徑,也可以是網(wǎng)絡(luò)圖片
九、列表
-
無序列表
使用+、-、或*標記無需列表,如下寫法+ 第一項
- 第二項
* 第三項效果如下
- 第一項
- 第二項
- 第三項
還可以通過寫 <li> 的形式標記列表項,如下寫法
<li> 項一
<li> 項二
效果為(部分解釋器可能不支持)
<li> 項一
<li> 項二
-
有序列表
使用數(shù)字.來表示,一般列表的第一個數(shù)字為起始編號數(shù)字,后面會自動加一排序,如下寫法1. 有序第一行
2. 有序第二行
3. 有序第三行2. 有序第一行
8. 有序第二行
1. 有序第三行效果如下
- 有序第一行
- 有序第二行
- 有序第三行
- 有序第一行
- 有序第二行
- 有序第三行
還可以通過寫 <ol start="1"><li>……<li> 的形式寫有序列表,如下寫法(部分解釋器可能不支持):
<ol><li> 有序項一
<li> 有序項二
<ol start="5"><li> 有序項一
<li> 有序項二
效果為:
<ol><li> 有序項一
<li> 有序項二
<ol start="5"><li> 有序項一
<li> 有序項二
注意:在列表中,若想實現(xiàn)縮進,即一個列表項下想把較多的內(nèi)容都縮進到列表項后面,需要在換行后的內(nèi)容的行首加3個空格
列表嵌套
列表嵌套需要在下一級列表前輸入3個空格,如下寫法(此處用 s 表示空格)
1. 一級有序列表
sss* 二級無需列表
效果如下
- 一級有序列表
- 二級無需列表
十、表格
表格語法如下
|表頭1|表頭2|表頭3|
|:---|:---:|----:|
|內(nèi)容|內(nèi)容|內(nèi)容|
|a|b|c|
顯示效果如下
表頭1 表頭2 表頭3 內(nèi)容 內(nèi)容 內(nèi)容 a b c
其中,最前面一列和最后一列的 | 可以省略不寫,第二行中的 : 指示此列的對齊方式,寫在左面為左對齊,寫在右面為右對齊,寫在兩端為居中
表格中寫列表時,可以采用第九章中描述的 <li> 或 <ol><li> 標記的形式實現(xiàn),如下寫法:
|表頭1|表頭2|表頭3|
|:---|:---:|----|
|內(nèi)容|內(nèi)容|內(nèi)容描述,下面是列表<br><li> 選項一 <li> 選項二|
|a|b|比較長的內(nèi)容,下面是有序列表<br><ol start="1"><li> 有序選項一 <li> 有序選項二|
顯示效果為(部分解釋器可能不支持):
| 表頭1 | 表頭2 | 表頭3 |
|---|---|---|
| 內(nèi)容 | 內(nèi)容 | 內(nèi)容描述,下面是列表 <li> 選項一 <li> 選項二 |
| a | b | 比較長的內(nèi)容,下面是有序列表 <ol start="1"><li> 有序選項一 <li> 有序選項二 |
十一、其它符號
轉(zhuǎn)義符號
\
轉(zhuǎn)義符號\用于輸出特殊符號-
代碼標識符號 '`'
代碼標識符號 ' ` ' 用于標記代碼,行內(nèi)使用時,使用 `代碼` 完成行內(nèi)標記,如:代碼
當不使用行內(nèi)代碼,而是標記代碼段時,在代碼段的前后用 ``` 包裹起來,如:```
int add(int a, int b)
{
return a + b;
}
```效果為
int add(int a, int b) { return a + b; }可以手動指定代碼的語言類型,語法為在第一個 '```' 后寫上語言名稱,如上所示代碼寫成下面的形式:
```cpp
int add(int a, int b)
{
return a + b;
}
```效果為:
int add(int a, int b) { return a + b; } -
數(shù)學公式轉(zhuǎn)義符號
$數(shù)學公式轉(zhuǎn)義符號用于轉(zhuǎn)義數(shù)學公式,當使用行內(nèi)公式時,使用一個
$符號 包裹公式,使用單獨一行的公式時,使用$$包裹公式,如下:行內(nèi)公式:$f(x)=ax+b$
$$E=mc^2$$效果為:
行內(nèi)公式:
關(guān)于數(shù)學公式的具體用法請參見:
雷震西山 2019年10月20日