MarkDown语法汇总20230720
MarkDown语法汇总
- Markdown 中文网 http://markdown.p2hp.com/
- markdown基础语法 http://markdown.p2hp.com/basic-syntax/
- markdown扩展语法 http://markdown.p2hp.com/extended-syntax/
- MarkDown语法汇总 https://blog.csdn.net/CynalFly/article/details/118880498
总览
Markdown是一种轻量级的标记语言，可用于将格式设置元素添加到纯文本文档中。Markdown 由John Gruber于2004年创建，如今已成为世界上最受欢迎的标记语言之一。
标题
1. 使用#号创建标题
使用 # 创建标题可以支持6级标题。你需要几级标题就输入几个 # 号，然后再输入一个空格后，即可生成所需要的标题。
# 1级标题
## 2级标题
### 3级标题
#### 4级标题
##### 5级标题
###### 6级标题
2. 使用=和-号创建标题
使用 = 可以创建一级标题，使用-可以创建二级标题。
一级标题
========
二级标题
--------
3. 使用标题#创建大纲
# 大纲标题
## 1. 一级1
### 1.1 二级1
#### 1.1.1 三级1
1. 内容1
2. 内容2
3. 内容3
#### 1.1.2 三级2
#### 1.1.3 三级3
### 1.2 二级2
### 1.3 二级3
## 2. 一级2
## 3. 一级3
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-JXrH0GFh-1689977039877)(MarkDown%E8%AF%AD%E6%B3%95%E6%B1%87%E6%80%BB20210718.assets/202307220423381.png)]
段落
段落直接输入文字就行了，切记行首不要带有空格Space 或制表符 Tab。
1. 换行
输入两个或两个以上空格结束一行，然后键入回车键 Enter.
2. 字体格式
*斜体字 >>就是在字的前后各添加一个星号*
_斜体字 >>也可以在字的前后各添加一个下划线_
**粗体字 >>就是在字的前后各添加两个星号**
__粗体字 >>也可以在字的前后各添加两个下划线__
***粗斜体字 >>就是在字的前后各添加三个星号***
___粗斜体字 >>也可以在字的前后各添加三个下划线___
斜体字 >>就是在字的前后各添加一个星号
斜体字 >>也可以在字的前后各添加一个下划线
粗体字 >>就是在字的前后各添加两个星号
粗体字 >>也可以在字的前后各添加两个下划线
粗斜体字 >>就是在字的前后各添加三个星号
粗斜体字 >>也可以在字的前后各添加三个下划线
3. 删除线
可以通过在段落的字体上放置一条横线来表示“删除”，表示这是错误的或不存在。要实现该功能只需要在文字的两端添加两个波浪线 ~~ 即可。
~~世界是平坦的。~~ 我们现在知道世界是圆的。
世界是平坦的。 我们现在知道世界是圆的。
4. 脚注
脚注使您可以添加注释和参考，而不会使文档正文混乱。创建脚注时，带有脚注引用的链接将出现带有链接的上标编号。读者可以单击链接跳至页面底部的脚注内容。
这是测试脚注[^标识符]。
这是数字脚注[^1]。这是文字脚注[^文本脚注]
[^标识符]: 标识符可以是数字或文本。但不能包含空格或制表符。
[^1]: 数字脚注测试说明。
[^文本脚注]: 文本脚注测试说明。
这是测试脚注1。
这是数字脚注2。这是文字脚注3
5. 下划线
Markdown本身并没有该语法，因为会和超链接样式混淆。所以如非不要请不要添加。
但可以使用html标签来实现（u指的是underline下划线）。
<u>需要添加下划线的内容u>
我不需要下划线，需要添加下划线的内容
6. 首行缩进
Markdown本身并没有该语法，但可以使用下面的语法（两个 ）替代传统的两个字符缩进。
Markdown本身并没有该语法，这只是一种非常简单的替代方法；当然Markdown语法支持html语句，可以直接用html标签来实现，请自行搜索学习。
Markdown本身并没有该语法，这只是一种非常简单的替代方法；当然Markdown语法支持html语句，可以直接用html标签来实现，请自行搜索学习。
7. 字体颜色、大小、字体类型
Markdown本身并没有该语法，但Markdown支持HTML的语法。
<font color="red">字体颜色font>、<font size=6>大小font>、<font size=5 face="隶书">字体类型font>
<font color="blue" size=3 face="楷体">这是蓝色3号楷体子font>
<font color="red">这是红色字体，可单独配置一项font>
<font size=6>这是4号字体，可单独配置一项font>
字体颜色、大小、字体类型
这是蓝色3号楷体子
这是红色字体，可单独配置一项
这是6号字体，可单独配置一项
8. 文本高亮
Markdown本身并没有该语法(扩展语法有，用==内容==)，但Markdown支持HTML的语法。
不需要==高亮==，<mark>重点提示需要高亮显示mark>，\<mark> 是HTML5的新标签。
不需要高亮，重点提示需要高亮显示， 是HTML5的新标签。
块引用
在段落的开头添加一个 > , 然后再键入一个空格。
> 块引用
> blockquote
块引用
blockquote
1. 嵌套块引用
区块可以嵌套，在需要的段落前面再添加一个 >。
> 嵌套主体
> > 第一层嵌套
> > > 第二层嵌套
嵌套主体
第一层嵌套
第二层嵌套
2. 具有其他元素的块引用
块引用可以包含其他Markdown格式的元素。并非所有元素都可以使用，您需要进行实验以查看哪些元素有效。
> ### 在块引用中添加标题
> 1. 在块引用添加项目编号
> 2. 在块引用添加项目编号
> + 在块引用添加项目符号
> - 在块引用添加项目符号
> - **粗体文本** 和 *斜体文本*
> ==高亮==
> <font size=5 color=red face=隶书>字体大小颜色</font>
> | 表格 | 表格 |
> | ---- | ---- |
> | 1 | 2 |
>
> ```sh
> #代码
> echo hello
> ```
在块引用中添加标题
- 在块引用添加项目编号
- 在块引用添加项目编号
- 在块引用添加项目符号
在块引用添加项目符号
粗体文本 和 斜体文本
高亮
字体大小颜色
表格 字体大小颜色 表格高亮 粗体文本 和 斜体文本 #代码 echo hello
列表
支持有序列表和无序列表。
1. 有序列表
只需要在前面添加添加数字和. ，然后键入空格Space。数字不必按数字顺序排列，但列表应以数字开头。
1. 第一项
2. 第二项
3. 第三项
4. 第四项
5. 第五项
6. 第六项
1. 缩进项（键入4个空格或制表符）
2. 缩进项（键入4个空格或制表符）
- 第一项
- 第二项
- 第三项
- 第四项
- 第五项
- 第六项
- 缩进项（键入4个空格或制表符）
- 缩进项（键入4个空格或制表符）
2. 无序列表
请在订单项前添加减号 -，星号 * 或加号 +。
- 第一项
- 第二项
* 第三项
* 第四项
+ 第五项
+ 第六项
+ 缩进项（键入4个空格或制表符）
- 缩进项（键入4个空格或制表符）
- 第一项
- 第二项
- 第三项
- 第四项
-
第五项
-
第六项
- 缩进项（键入4个空格或制表符）
- 缩进项（键入4个空格或制表符）
代码
要将段落中的函数或其他表达式表示为代码，请将其括在勾号 ` 中。
`main()`函数中调用`printf()`函数
main()函数中调用printf()函数
1. 代码块
要创建代码块，请在代码块的每一行缩进至少四个空格 Space 或一个制表符 Tab 。
for(i=0; i<8; i++) {
printf("这是代码块测试代码");
delay_ms(1000); /* 延时1s */
}
for(i=0; i<8; i++) {
printf(“这是代码块测试代码”);
delay_ms(1000); /* 延时1s */
}
2. 围栏代码块
根据Markdown处理器或编辑器的不同，您将在代码块之前和之后的行上使用三个刻度线 ```或三个波浪号~~~ ；如果需要高亮显示，请指定对应的语言，诸如C、C++、JAVA、Python等等。
```c
for(i=0; i<8; i++) {
printf("这是代码块测试代码");
delay_ms(1000); /* 延时1s */
}
```
for(i=0; i<8; i++) {
printf("这是代码块测试代码");
delay_ms(1000); /* 延时1s */
}
链接
创建链接时，首先在方括号中填写链接文本（例如[链接名称]），然后再紧跟方括号的括号（例如(https://www.baidu.com/)）中填写链接地址URL。
我常用的搜索引擎是 [百度](https://www.baidu.com/)
我常用的搜索引擎是 百度
1. 为链接添加标题
您可以选择为链接添加标题。当用户将鼠标悬停在链接上时，这将显示为工具提示。要添加标题，直接在URL后面键入空格 Space 后添加标题。
我常用的搜索引擎是 [百度](https://www.baidu.com/ "众里寻他千百度")。
我常用的搜索引擎是 百度。
2. 网址和电子邮件地址
要将URL或电子邮件地址快速转换为链接，请将其括在尖括号
<https://markdown.p2hp.com>
<[email protected]>
https://markdown.p2hp.com
[email protected]
3. 格式化链接
为了强调链接，请在方括号和括号之前和之后添加星号。
其实就是相当于段落中字体格式的设置。
图片
要添加图像，请在链接的前面添加感叹号（!），然后在括号中添加替代文本，并在括号中添加图像资源的路径或URL。您可以选择在括号中的URL之后添加标题。
这里需要提下markdown文本工具使用图床工具上传图片到外网再引用：
PicGo+Gitee实现Typora图床功能 https://blog.csdn.net/Yohann17/article/details/128533277
图床及typora配置图床（gitee+picgo）https://blog.csdn.net/qqzhuimengren/article/details/120748085
表格
要添加表格，请使用三个或多个连字符 — 创建每列的标题，并使用竖线 | 分隔每列。
使用html的rowspan="2"、合并列colspan="2"、水平对齐text-align=center/left/right、垂直对齐vertical-align:middle/top/bottom等更复杂的操作。
| 标题 | 标题 |
| ------ | ------ |
| 单元格 | 单元格 |
| 单元格 | 单元格 |
| 1 | |
<table>
<tr>
<td rowspan="2" style="vertical-align:middle;text-align:center"><mark>合并行mark>td>
<td align=center><mark>居中对齐mark>td>
<td>单元格3td>
tr>
<tr>
<td align=left><mark>居左对齐mark>td>
<td align=right><mark>居右对齐mark>td>
tr>
<tr>
<td>单元格4td>
<td colspan="2" align=center><mark>合并列mark>td>
tr>
table>
| 标题 | 标题 |
|---|---|
| 单元格 | 单元格 |
| 单元格 | 单元格 |
| 1 |
| 合并行 | 居中对齐 | 单元格3 |
| 居左对齐 | 居右对齐 | |
| 单元格4 | 合并列 | |
1. 使用图形界面创建表格
使用字符创建表格很费事、很麻烦，为了加快这一过程,我们可以使用在线表格生成器Markdown Tables Generator，不出意外的话访问不了。https://www.tablesgenerator.com/markdown_tables
2. 对齐方式
要实现类似Excel文本的左对齐、居中、右对齐，只需要在连字符的左侧、两侧、右侧添加冒号 : 即可。
| 物料编号 | 物料名称 | 物料封装 |
|---|---|---|
| 1 | PCB板 | Main Board |
| 2 | SPC5634MF2MLQ80 | LQFP144 |
| 1 |
转义字符
Markdown使用很多字符表示特定的意思，要显示原义字符，请在字符的前面添加反斜杠 \ ,这样就可以转义字符了。
#### 没有使用反斜杠，这是4级标题
\#### 使用反斜杠，这就是4个#号
没有使用反斜杠，这是4级标题
#### 使用反斜杠，这就是4个#号
1. 可以转义的字符
| 字符 | 名称 |
|---|---|
| \ | 反斜杠 |
| ` | 刻度线 |
| * | 星号 |
| _ | 下划线 |
| {} | 大括号 |
| [] | 中括号 |
| () | 括号 |
| # | 井号 |
| + | 加号 |
| - | 减号（连字符） |
| . | 点 |
| ! | 感叹号 |
| | | 竖线 |
参考
- Markdown 中文网 http://markdown.p2hp.com/
- markdown基础语法 http://markdown.p2hp.com/basic-syntax/
- markdown扩展语法 http://markdown.p2hp.com/extended-syntax/
- MarkDown语法汇总 https://blog.csdn.net/CynalFly/article/details/118880498
标识符可以是数字或文本。但不能包含空格或制表符。 ↩︎
数字脚注测试说明。 ↩︎
文本脚注测试说明。 ↩︎