Markdown語法說明及測試一覽表

Markdown 目錄

在文中放置[toc]

Markdown 標題

在標題前放置 1~6 個#號再帶一個空格

# 一級標題

## 二級標題

### 三級標題

#### 四級標題

##### 五級標題

###### 六級標題

一級標題

二級標題

三級標題

四級標題

五級標題

六級標題

Markdown 段落格式

常用通用部分

用 1~3 個*包裹文本分別實現斜體、粗體、粗斜體，不推薦使用_。
這是*包裹的斜體文本，這是_包裹的_斜體_文本
這是**包裹的粗體文本，這是__包裹的__粗體__文本
這是***包裹的粗斜體文本，這是___包裹的___粗斜體___文本

非常用通用部分

下標：使用~包裹文本，如 H₂O
上標：使用^包裹文本，如 X²
高亮：使用==包裹文本，如highlight
刪除線：使用~~包裹文本，如~~刪除線~~
下劃線：使用包裹文本，如帶下劃線文本

腳注：

腳注[^腳注文本]
[^腳注文本]: 腳注的內容

腳注^[1]

分隔線：3 個及以上連續的-

Markdown 列表

無序列表

在-后面帶一個空格，不推薦使用 + 和 *。

無序列表1

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

無序列表

無序列表

無序列表

無序列表2

- 無序列表
- 無序列表
- 無序列表

無序列表
無序列表
無序列表

無序列表3

- 無序列表

- 無序列表

- 無序列表

無序列表
無序列表
無序列表

有序列表

在阿拉伯數字后面帶一個.和一個空格

有序列表1

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

有序列表
有序列表
有序列表

有序列表2

1. 有序列表

2. 有序列表

3. 有序列表

有序列表
有序列表
有序列表

列表嵌套

在無序列表中嵌套對象，需要在對象的行首放置 2 個空格。
在有序列表中嵌套對象，需要在對象的行首放置 3 個空格。

列表嵌套1

- 列表嵌套
  1. 列表嵌套
  2. 列表嵌套
  - 列表嵌套
  - 列表嵌套

列表嵌套
1. 列表嵌套
2. 列表嵌套
- 列表嵌套
- 列表嵌套

列表嵌套2

1. 列表嵌套
   1. 列表嵌套
   2. 列表嵌套
   - 列表嵌套
   - 列表嵌套

列表嵌套
1. 列表嵌套
2. 列表嵌套
- 列表嵌套
- 列表嵌套

列表嵌套3

1. 列表嵌套

   1. 列表嵌套

   2. 列表嵌套

   - 列表嵌套

   - 列表嵌套

列表嵌套
1. 列表嵌套
2. 列表嵌套
- 列表嵌套
- 列表嵌套

任務列表

在 + 后面帶一個空格，在空格后再帶一個 [ ] ， [ ] 的后面再帶一個空格， [ ] 里面為一個空格時表示任務未完成， [ ] 里面為一個 x 時表示任務已完成。不推薦使用 - 和 *。

任務列表1

+ [x] 已完成任務1
+ [x] 已完成任務2
- [ ] 待完成任務3
* [ ] 待完成任務4

已完成任務1
已完成任務2

待完成任務3

待完成任務4

任務列表2（行尾帶兩個空格，即硬換行）

+ [x] 已完成任務1  
+ [x] 已完成任務2  
+ [x] 已完成任務3

已完成任務1
已完成任務2
已完成任務3

任務列表3（兩行之間有空行，即換段）

+ [x] 已完成任務1

+ [x] 已完成任務2

+ [x] 已完成任務3

已完成任務1
已完成任務2
已完成任務3

任務列表4

+ [x] 已完成任務1
  + [x] 已完成任務2
  + [x] 已完成任務3

已完成任務1
- 已完成任務2
- 已完成任務3

Markdown 區塊

區塊引用

行首放置 1 個 >，推薦再帶一個空格，推薦行尾帶兩個空格。

區塊引用1

> 區塊引用
> 區塊引用

區塊引用
區塊引用

區塊引用2（行尾帶兩個空格，即硬換行）

> 區塊引用  
> 區塊引用

區塊引用
區塊引用

區塊引用3（兩行之間有空行，即換段）

> 區塊引用
>
> 區塊引用

區塊引用

區塊引用

區塊引用嵌套

在行首放置多個 > ，段落和列表的下一行放置 > 時會自動對區塊引用進行嵌套

> 最外層
> > 第一層嵌套
> > > 第二層嵌套

最外層

第一層嵌套

第二層嵌套

Markdown 鏈接

普通鏈接

<鏈接地址>
[鏈接名稱](鏈接地址)
[鏈接名稱](鏈接地址 "可選標題")

<https://markdown-here.com>
[Markdown Here](https://markdown-here.com)
[Markdown Here](https://markdown-here.com "Markdown Here 標題")

https://markdown-here.com

Markdown Here

錨點鏈接（在文檔的結尾為變量賦值）

[鏈接名稱][網址變量]
[網址變量]:鏈接地址

[Markdown Here][markdown_here_url]
[Markdown_Here_url]:https://markdown-here.com

Markdown Here

Markdown 圖片

一般圖片鏈接

![alt 屬性文本](圖片地址)
![alt 屬性文本](圖片地址 '可選標題')
![alt 屬性文本](圖片地址 "可選標題")

![夢幻之心星](https://img.skyseeker.eu.org/icon/dream-seeker.jpg)
![夢幻之心星](https://img.skyseeker.eu.org/icon/dream-seeker.jpg '夢幻之心星'))
![夢幻之心星](https://img.skyseeker.eu.org/icon/dream-seeker.jpg "夢幻之心星")

高級鏈接

在文檔的結尾為變量賦值

![alt 屬性文本][圖片地址變量]
[圖片地址變量]: 圖片地址

![夢幻之心星][Sky-seeker_url]
[Sky-seeker_url]: https://img.skyseeker.eu.org/icon/dream-seeker.jpg

<img src="https://markdown-here.com/img/icon256.png" width="50%">

![夢幻之心星][Sky-seeker_url]
[Sky-seeker_url]: https://img.skyseeker.eu.org/icon/dream-seeker.jpg

Markdown 代碼

行內代碼

用 ` 包裹行內代碼

代碼區塊

推薦使用```包裹代碼塊并聲明所用語言，不推薦在代碼塊的行首放置 4 個空格或 1 個制表符，推薦在段落和代碼區塊之間放置一個空行。

行首放置空格

在代碼塊的行首放置 4 個空格，段落和代碼區塊之間至少空一行。

h1  {
font-size: 24px;
text-align: left;
background-repeat: no-repeat;
background-position:center left;
}

包裹代碼塊

段落和代碼區塊之間可以有空行

h1  {
font-size: 24px;
text-align: left;
background-repeat: no-repeat;
background-position:center left;
}

Markdown 表格

用 | 分隔單元格，用 - 分隔表頭和其他行，用 : 控制對齊方式

| 表頭   | 左對齊 | 右對齊 | 居中對齊 |
| ------ | :----- | -----: | :------: |
| 單元格 | 單元格 | 單元格 |  單元格  |
| 單元格 | 單元格 | 單元格 |  單元格  |

表頭	左對齊	右對齊	居中對齊
單元格	單元格	單元格	單元格
單元格	單元格	單元格	單元格

Markdown 高級技巧

支持的 HTML 元素

不在 Markdown 涵蓋范圍內的標簽，都能直接使用。目前支持的 HTML 元素有：<kbd> 等。

1. 使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重啟電腦
2. 特殊符號 &copy; &trade; &amp; 18&ordm;C
3. <span style="color: red;">這是一行紅色的文字</span>
4. 插入視頻
<video src="$appres/images/example.mp4"></video>
5. Emoji 表情 :smiley:

使用 Ctrl+Alt+Del 重啟電腦
特殊符號 ? ? & 18oC
這是一行紅色的文字
插入視頻
Emoji 表情 ??

轉義

Markdown 使用了很多特殊符號來表示特定的意義，如果需要顯示特定的符號則需要使用轉義字符，Markdown 使用反斜杠轉義特殊字符。

數學公式

使用美元符 $ 包裹 TeX 或 LaTeX 格式的數學公式

行內公式 $E=mc^2$ ，如 $E=mc^2$
塊公式

$$
\sum_{i=1}^n a_i=0
$$

$$
\mathbf{V}_1 \times \mathbf{V}_2 =  \begin{vmatrix}
\mathbf{i} & \mathbf{j} & \mathbf{k} \\
\frac{\partial X}{\partial u} &  \frac{\partial Y}{\partial u} & 0 \\
\frac{\partial X}{\partial v} &  \frac{\partial Y}{\partial v} & 0 \\
\end{vmatrix}
{$tep1}{\style{visibility:hidden}{(x+1)(x+1)}}
$$

\[\sum_{i=1}^n a_i=0 \]

\[\mathbf{V}_1 \times \mathbf{V}_2 = \begin{vmatrix} \mathbf{i} & \mathbf{j} & \mathbf{k} \\ \frac{\partial X}{\partial u} & \frac{\partial Y}{\partial u} & 0 \\ \frac{\partial X}{\partial v} & \frac{\partial Y}{\partial v} & 0 \\ \end{vmatrix} {$tep1}{\style{visibility:hidden}{(x+1)(x+1)}} \]

畫圖

餅圖 `mermaid pie`

pie title 餅圖 "Joplin" : 42.96 "Qdown" : 50.05 " 黑科技" : 10.01 "其它" : 5

橫向流程圖 `mermaid graph LR`

graph LR A[方形] -->B(圓角) B --> C{條件a} C -->|a=1| D[結果1] C -->|a=2| E[結果2] F[橫向流程圖]

豎向流程圖 `mermaid graph TD`

graph TD A[方形] --> B(圓角) B --> C{條件a} C --> |a=1| D[結果1] C --> |a=2| E[結果2] F[豎向流程圖]

標準流程圖 `flow`

st=>start: 開始框
op=>operation: 處理框
cond=>condition: 判斷框(是或否?)
sub1=>subroutine: 子流程
io=>inputoutput: 輸入輸出框
e=>end: 結束框
st->op->cond
cond(yes)->io->e
cond(no)->sub1(right)->op

標準流程圖（橫向） `flow`

st=>start: 開始框
op=>operation: 處理框
cond=>condition: 判斷框(是或否?)
sub1=>subroutine: 子流程
io=>inputoutput: 輸入輸出框
e=>end: 結束框
st(right)->op(right)->cond
cond(yes)->io(bottom)->e
cond(no)->sub1(right)->op

UML 時序圖 `sequence`

對象A->對象B: 對象B你好嗎?（請求）
Note right of 對象B: 對象B的描述
Note left of 對象A: 對象A的描述(提示)
對象B-->對象A: 我很好(響應)
對象A->對象B: 你真的好嗎？

UML 復雜時序圖 `sequence`

Title: 標題：復雜使用
對象A->對象B: 對象B你好嗎?（請求）
Note right of 對象B: 對象B的描述
Note left of 對象A: 對象A的描述(提示)
對象B-->對象A: 我很好(響應)
對象B->小三: 你好嗎
小三-->>對象A: 對象B找我了
對象A->對象B: 你真的好嗎？
Note over 小三,對象B: 我們是朋友
participant C
Note right of C: 沒人陪我玩

UML 標準時序圖 `mermaid`

%% 時序圖例子,-> 直線，-->虛線，->>實線箭頭 sequenceDiagram participant 張三 participant 李四張三->王五: 王五你好嗎？ loop 健康檢查王五->王五: 與疾病戰斗 end Note right of 王五: 合理食物 看醫生... 李四-->>張三: 很好! 王五->李四: 你怎么樣? 李四-->王五: 很好!

甘特圖 `mermaid`

gantt dateFormat YYYY-MM-DD title 軟件開發甘特圖 section 設計需求 :done, des1, 2014-01-06,2014-01-08 原型 :active, des2, 2014-01-09, 3d UI設計 : des3, after des2, 5d 未來任務 : des4, after des3, 5d section 開發學習準備理解需求 :crit, done, 2014-01-06,24h 設計框架 :crit, done, after des2, 2d 開發 :crit, active, 3d 未來任務 :crit, 5d 耍 :2d section 測試功能測試 :active, a1, after des3, 3d 壓力測試 :after a1 , 20h 測試報告 : 48h

博客園地址：http://www.rzrgm.cn/Sky-seeker

微信公眾號：關注微信公眾號，獲取即時推送

腳注的內容 ??

posted @ 2020-06-03 17:26 夢幻之心星閱讀(766) 評論(1) 收藏舉報

刷新頁面返回頂部

夢幻之心星

博學之，審問之，慎思之，明辨之，篤行之。