本文包含的Markdown語法有：
- 標(biāo)題
- 文字
- 粗斜體
- 劃線
- 腳注
- 段落
- 換行
- 分隔符
- 列表
- 區(qū)塊引用
- 代碼
- 鏈接
- 圖片
- 表格
- 目錄
- 注釋
- 支持的HTML元素
- 轉(zhuǎn)義字符
標(biāo)題
在Markdown 中標(biāo)題可以使用兩種方式來
- 一種是用
=或- - 一種是用
#
1. 使用=或-
至少用三個(gè) =或-
代碼示例:
一級標(biāo)題
===
二級標(biāo)題
---
2. 使用#
在想要設(shè)置為標(biāo)題的文字前面加#來表示
#后面要加空格- 一個(gè)#是一級標(biāo)題，二個(gè)#是二級標(biāo)題柠傍，以此類推荒揣。支持六級標(biāo)題北专。
代碼示例:
# 一級標(biāo)題
## 二級標(biāo)題
### 三級標(biāo)題
#### 四級標(biāo)題
##### 五級標(biāo)題
###### 六級標(biāo)題
文字
粗斜體
在MarkDown里萧福，粗耻矮、斜體有兩種寫法忧吟，一種是用 * 被啼，一種是用 _ 包裹住你要改變的內(nèi)容
在 * 或 _ 與內(nèi)容要緊貼著试躏，之前不能用空格
- 一個(gè)
*或一個(gè)_是斜體 - 兩個(gè)
*或兩個(gè)_是粗體 - 三個(gè)
*或三個(gè)_是粗斜體
代碼示例:
*斜體文本* _斜體文本_
**粗體文本** __粗體文本__
***粗斜體文本*** ___粗斜體文本___
示例效果:
斜體文本
粗體文本
粗斜體文本
劃線
在MarkDown中沒有上劃線和下劃線的自身語法猪勇，只有刪除線(中劃線)的語法，但可以通過其他方式實(shí)現(xiàn)
- 上劃線可以通過
Latex公式實(shí)現(xiàn) - 刪除線(中劃線)
- 下劃線使用
HTML語法或Latex公式 實(shí)現(xiàn)
代碼示例:
<!--通過Latex公式實(shí)現(xiàn)上劃線-->
$\overline{\text{上劃線}}$
~~刪除線~~
<!--通過Latex公式實(shí)現(xiàn)下劃線-->
$\underline{\text{下劃線}}$
<!--通過HTML標(biāo)簽實(shí)現(xiàn)下劃線-->
<u>下劃線</u>
示例效果:
刪除線
<u>下劃線</u>
腳注
在MarkDown中支持添加腳注方式來對文本進(jìn)行補(bǔ)充說明颠蕴。
在需要添加注腳的文字后加上腳注名： [^注腳名] 泣刹。 然后在文本的任意位置(一般在最后)添加腳注：
腳注自動(dòng)生成在頁面最最后面，在頁面末尾可以看到裁替，并且腳注后方的鏈接可以直接跳轉(zhuǎn)回到加腳注的地方棋恼。
代碼示例:
腳注示例，這是第一個(gè)腳注[^注腳名1]衅斩，這是第二個(gè)腳注[^注腳名2]勘伺，這是第三個(gè)腳注[^注腳名3]
[^注腳名1]:我是腳注一.
[^注腳名2]:我是腳注二.
[^注腳名3]:我是腳注三.
示例效果:
腳注示例，這是第一個(gè)腳注[1]昌腰，這是第二個(gè)腳注[2]开伏，這是第三個(gè)腳注[3]
段落
換行
在Markdown 段落沒有特殊的格式
- 當(dāng)需要內(nèi)容換行時(shí)，使用兩個(gè)以上空格加上回車遭商。
- 當(dāng)需要生成新的段落固灵，只需空出一行即可
多個(gè)空行只生效一個(gè)空行
代碼示例:
上一行內(nèi)容
下一行內(nèi)容
上一個(gè)段落
下一個(gè)段落
示例效果:
上一行內(nèi)容
下一行內(nèi)容
上一個(gè)段落
下一個(gè)段落
分隔符
在Markdown 分隔符需要使用 * 或 - 或 _來建立
*或-或_都需要三個(gè)及其以上*或-或_可以在中間插入空格，但不能在行內(nèi)存在其他內(nèi)容*或-或_劫流，當(dāng)前后都有段落時(shí)巫玻，請空出一行
代碼示例:
---
- - -
___
_ _ _
***
* * *
示例效果:
列表
無序列表
列表內(nèi)容前可使用 * 或 - 或 + + 空格來表示無序列表
代碼示例:
- 無序列表項(xiàng)，使用 `-` + `空格`
+ 無序列表項(xiàng)祠汇，使用 `+` + `空格`
* 無序列表項(xiàng)仍秤，使用 `*` + `空格`
示例效果:
- 無序列表項(xiàng)，使用
-+空格
- 無序列表項(xiàng)可很，使用
++空格
- 無序列表項(xiàng)诗力，使用
*+空格
有序列表
列表內(nèi)容前可使用 數(shù)字+空格來表示有序列表
有序列表會(huì)自動(dòng)給你的列表項(xiàng)按照阿拉伯?dāng)?shù)字順序添加數(shù)字
代碼示例:
1. 第一項(xiàng)
2. 第二項(xiàng)
4. 第三項(xiàng)
示例效果:
- 第一項(xiàng)
- 第二項(xiàng)
- 第三項(xiàng)
列表嵌套
子列表中的列表項(xiàng)前添加四個(gè)空格
代碼示例:
1. 有序列表第一項(xiàng) A
- A 的第一項(xiàng)無序列表子項(xiàng) a1
1. a1 的第一項(xiàng)有序列表子項(xiàng) a1a
1. a1 的第二項(xiàng)有序列表子項(xiàng) a1b
- A 的第二項(xiàng)無序列表子項(xiàng) a2
2. 有序列表第一項(xiàng) B
B 的第一行文本內(nèi)容
B 的第二行文本內(nèi)容
示例效果:
- 有序列表第一項(xiàng) A
- A 的第一項(xiàng)無序列表子項(xiàng) a1
- a1 的第一項(xiàng)有序列表子項(xiàng) a1a
- a1 的第二項(xiàng)有序列表子項(xiàng) a1b
- A 的第二項(xiàng)無序列表子項(xiàng) a2
- A 的第一項(xiàng)無序列表子項(xiàng) a1
- 有序列表第一項(xiàng) B
B 的第一行文本內(nèi)容
B 的第二行文本內(nèi)容
區(qū)塊引用
簡單區(qū)塊引用
在Markdown中使用 > + 空格 來表示區(qū)塊引用
當(dāng)需要換行時(shí)，可以在前方不加 >
需要新板塊可以空出一行
代碼示例:
> 換行可以不加 `>`
我前面沒有 `>`
> 如果需要新的一塊我抠，塊引用則空出一行重新在文本前方使用 `>`
示例效果:
換行可以不加
>
我前面沒有>
如果需要新的一塊苇本，塊引用則空出一行重新在文本前方使用
>
區(qū)塊引用的嵌套
在Markdown中袜茧，區(qū)塊引用也可以進(jìn)行嵌套,只需使用多個(gè) >
嵌套區(qū)塊引用使用 > 的個(gè)數(shù)，代表著嵌套的深度
嵌套區(qū)塊引用中 > 之間可以不用空格隔開
代碼示例:
>> 第二層
> 第一層
> > 第二層
> 第一層
> > > 第三層
示例效果:
第二層
第一層
第二層
第一層
第三層
區(qū)塊引用與列表
在Markdown中瓣窄，列表里面可以使用區(qū)塊引用笛厦，區(qū)塊引用中也可以使用列表
列表還可以嵌套列表，區(qū)塊引用還可以嵌套區(qū)塊(本章只做簡單介紹)
- 列表中使用區(qū)塊引用
代碼示例:
1. 有序列表 A
> 引用區(qū)塊
1. 有序列表 Aa
> 引用區(qū)塊
> 區(qū)塊
2. 有序列表 B
示例效果:
- 有序列表 A
引用區(qū)塊
1. 有序列表 Aa
> 引用區(qū)塊
> 區(qū)塊 - 有序列表 B
- 區(qū)塊引用中使用列表
代碼示例:
> - 這序列表 A
> - 無序列表 B
> * 子列表需要在 `>` 后面加入四個(gè)空格
示例效果:
- 這序列表 A
- 無序列表 B
- 子列表需要在
>后面加入四個(gè)空格
代碼
建議有輸出內(nèi)容的 Shell 命令前加上$,不會(huì)把命令和輸出的內(nèi)容混淆
-
代碼段
代碼段可以使用一對反引號` `包裹住
代碼示例:
文本段中使用`代碼段`,就用反引號包裹住
示例效果:
文本段中使用代碼段,就用反引號包裹住
-
代碼區(qū)塊
- 每行文字前加4個(gè)空格 - 每行文字前加1個(gè)<kbd>tab</kbd>鍵 - 使用三個(gè)反引號```包裹一段代碼康栈，在第一個(gè)```后面可以指定代碼語言递递，顯示代碼高亮，也可以不指定語言
使用三個(gè)引號包裹代碼塊啥么，引號是放在最前方
代碼示例:
我是使用4個(gè)空格登舞，形成的代碼塊
我是使用一個(gè)1個(gè)<kbd>tab</kbd>鍵，形成的惡代碼塊
```markdown
markdown代碼
# 標(biāo)題
1. 有序列表
```
示例效果:
我是使用4個(gè)空格悬荣，形成的代碼塊
我是使用一個(gè)1個(gè)<kbd>tab</kbd>鍵菠秒，形成的惡代碼塊
markdown代碼
# 標(biāo)題
1. 有序列表
鏈接
在Markdown中，鏈接可以使用到變量
-
簡單鏈接
[鏈接名稱](鏈接網(wǎng)址)[鏈接名稱](鏈接網(wǎng)址 "文字說明")<鏈接網(wǎng)址>
文字說明可以通過鼠標(biāo)懸浮鏈接上查看
代碼示例:
百度[百度](https://www.baidu.com/)
百度[百度](https://www.baidu.com/ "百度搜索")
百度<https://www.baidu.com/>
示例效果:
百度百度
百度百度
百度https://www.baidu.com/
-
高級鏈接
可以使用變量來調(diào)用鏈接
使用變量要記得在文檔的結(jié)尾為變量賦值
代碼示例:
[百度][1]
[谷歌][2]
然后在文檔的結(jié)尾為變量賦值（網(wǎng)址）
[1]: https://www.baidu.com/
[2]: http://www.google.com/
示例效果:
然后在文檔的結(jié)尾為變量賦值（網(wǎng)址）
圖片
跟鏈接的方法區(qū)別在于前面加了個(gè)感嘆號 !
[圖片上傳失敗...(image-caa9b7-1632883183326)][圖片上傳失敗...(image-4d432f-1632883183327)]你也可以像鏈接一樣使用變量[百度][1].
然后在文檔的結(jié)尾位變量賦值（網(wǎng)址）
__
代碼示例:
![百度logo]](https://www.baidu.com/img/PCtm_d9c8750bed0b3c7d089fa7d55720d6cf.png)
[百度][1]
[1]: https://www.baidu.com/
示例效果:
表格
在Markdown中 制作表格使用 | 來分隔不同的單元格氯迂，使用 - 來分隔表頭和其他行践叠。
表格對齊放方式
- -: 設(shè)置內(nèi)容和標(biāo)題欄居右對齊。
- :- 設(shè)置內(nèi)容和標(biāo)題欄居左對齊嚼蚀。
- :-: 設(shè)置內(nèi)容和標(biāo)題欄居中對齊禁灼。
表格對齊都是寫在表頭下面一行的 ---- 中
代碼示例:
| 表頭一 | 靠左對齊 | 居中對其 | 靠右對齊 |
| :----- | :-----| ----: | :----: |
| 單元格1 | 單元格2 | 單元格3 | 單元格4 |
| 單元格11 | 單元格22 | 單元格33 | 單元格44 |
| 單元格111 | 單元格222 | 單元格333 | 單元格444 |
| 單元格1111 | 單元格2222 | 單元格3333 | 單元格4444 |
示例效果:
| 表頭一 | 靠左對齊 | 居中對其 | 靠右對齊 |
|---|---|---|---|
| 單元格1 | 單元格2 | 單元格3 | 單元格4 |
| 單元格11 | 單元格22 | 單元格33 | 單元格44 |
| 單元格111 | 單元格222 | 單元格333 | 單元格444 |
| 單元格1111 | 單元格2222 | 單元格3333 | 單元格4444 |
目錄
在需要目錄出現(xiàn)的地方（一般在文章一開始）放置一個(gè)標(biāo)記，這樣會(huì)自動(dòng)生成一個(gè)嵌套的包含所有標(biāo)題的列表轿曙。
如果對應(yīng)的各級標(biāo)題中有空格 , 在錨點(diǎn)鏈接中用-代替空格
代碼示例:
本文目錄示例
- [標(biāo)題](#標(biāo)題)
- [文字](#文字)
- [粗斜體](#粗斜體)
- [劃線](#劃線)
- [腳注](#腳注)
- [段落](#段落)
- [換行](#換行)
- [分隔符](#分隔符)
- [列表](#列表)
- [無序列表](#無序列表)
- [有序列表](#有序列表)
- [列表嵌套](#列表嵌套)
- [區(qū)塊引用](#區(qū)塊引用)
- [簡單區(qū)塊引用](#簡單區(qū)塊引用)
- [區(qū)塊引用的嵌套](#區(qū)塊引用的嵌套)
- [區(qū)塊引用與列表](#區(qū)塊引用與列表)
- [代碼](#代碼)
- [鏈接](#鏈接)
- [圖片](#圖片)
- [表格](#表格)
- [目錄](#目錄)
- [高級技巧](#高級技巧)
- [注釋](#注釋)
- [支持的html元素](#支持的html元素)
- [轉(zhuǎn)義字符](#轉(zhuǎn)義字符)
示例效果:
本文目錄示例
高級技巧
注釋
在Markdown中弄捕，注釋可以自定義
- 可以使用html語法注釋``
- 可以使用
*[·-·]:注釋內(nèi)容格式進(jìn)行注釋，其中[]中的內(nèi)容可以自定義
這些注釋在代碼段中無效导帝，代碼塊中注釋是根據(jù)所指定語言進(jìn)行注釋
代碼示例:
<!--注釋守谓，不會(huì)顯示-->
[comment]: <> (注釋，不會(huì)顯示)
[//]: <> (注釋您单，不會(huì)顯示)
[//]: # (注釋斋荞，不會(huì)顯示)
*[^_^]:注釋，不會(huì)顯示
*[@_@]:注釋虐秦，不會(huì)顯示
示例效果:
下面寫了注釋平酿，但不會(huì)被解析渲染出現(xiàn)，不同解析器支持的結(jié)果不同悦陋。
[comment]: <> (注釋染服，不會(huì)顯示)
[//]: <> (注釋，不會(huì)顯示)
[//]: # (注釋叨恨，不會(huì)顯示)
*[_]:注釋，不會(huì)顯示
*[@_@]:注釋挖垛，不會(huì)顯示
支持的html元素
目前支持的 HTML 元素有：<kbd> <b> <i> <em> <sup> <sub> <br>等
不在 Markdown 涵蓋范圍之內(nèi)的標(biāo)簽痒钝，都可以直接在文檔里面用 HTML 撰寫秉颗。
代碼示例:
<kbd>tab</kbd>鍵
<b>粗體</b>
<i>斜體</i>
<em>也是斜體</em>
文本<sup>上標(biāo)</sup>
文本<sub>下標(biāo)</sub>
換行<br>下一行
<details>
<summary>點(diǎn)擊查看</summary>
這里是折疊的內(nèi)容
</details>
還有很多其他html標(biāo)簽，這里就不一一列舉了...
示例效果:
<kbd>tab</kbd>鍵
<b>粗體</b>
<i>斜體</i>
<em>也是斜體</em>
文本上標(biāo)
文本下標(biāo)
換行
下一行
<details>
<summary>點(diǎn)擊查看</summary>
這里是折疊的內(nèi)容
</details>
還有很多其他html標(biāo)簽送矩，這里就不一一列舉了...
轉(zhuǎn)義字符
在Markdown 中使用了很多特殊符號蚕甥，如果需要顯示特定的符號則需要使用轉(zhuǎn)義字符《拜可以使用反斜杠\來轉(zhuǎn)義
Markdown反斜杠轉(zhuǎn)義表
| 轉(zhuǎn)義字符 | 中文名稱 | 英文名稱 |
|---|---|---|
| \ | 反斜杠 | backslash |
| ` | 反引號 | backtick |
| * | 星號 | asterisk |
| _ | 下劃線 | underscore |
| {} | 大括號 | curly braces |
| [] | 方括號 | square brackets |
| () | 括弧 | parentheses |
| # | 井號 | hash mark |
| + | 加號 | plus sign |
| - | 減號（連字符） | minus sign (hyphen) |
| . | 小數(shù)點(diǎn) | dot |
| ! | 感嘆號 | exclamation mark |
代碼示例:
\\ 反斜線
\` 反引號
\* 星號
\_ 下劃線
\{} 花括號
\[] 方括號
\() 小括號
\# 井字號
\+ 加號
\- 減號
\. 英文句點(diǎn)
\! 感嘆號
示例效果:
\ 反斜線
` 反引號
* 星號
_ 下劃線
{} 花括號
[] 方括號
() 小括號
# 井字號
+ 加號
- 減號
. 英文句點(diǎn)
! 感嘆號
