> 前言:博主自从使用了markdown编辑器之后,就像坠入爱河,其他编辑器抛诸脑后,眼里只有markdown,它的语法其实并不难,花点心思,多敲几下就能上手,本篇是我自己使用过程中整理的一些语法,内容较多,有需要的同学可以自行收录,后续如果有新的比较好用的语法也会更新在本篇随笔。其中部分内容的收录源自[菜鸟教程](https://www.runoob.com/markdown/md-advance.html),[WebFX](https://www.webfx.com/tools/emoji-cheat-sheet/),[W3school](https://www.w3school.com.cn/tags/html_ref_colornames.asp)。
# Markdown 标题
Markdown 标题有两种格式。
## 使用 = 和 - 标记一级和二级标题
= 和 - 标记语法格式如下:
```
我展示的是一级标题
=================
我展示的是二级标题
-----------------
```
显示效果如下图:
![](https://images.cnblogs.com/cnblogs_com/miki-peng/1671561/o_200316041520image-20200218230129458.png)
## 使用 # 号标记
使用 **#** 号可表示 1-6 级标题,一级标题对应一个 **#** 号,二级标题对应两个 **#** 号,以此类推。
```
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
```
显示效果如下图:
![](https://images.cnblogs.com/cnblogs_com/miki-peng/1671561/o_200316041525image-20200218230222368.png)
# Markdown 段落
Markdown 段落没有特殊的格式,直接编写文字就好,**段落的换行是使用两个以上空格加上回车**。
![image-20191026101845235](https://images.cnblogs.com/cnblogs_com/miki-peng/1671561/o_200316041530image-20191026101845235.png)
## 字体
Markdown 可以使用以下几种字体:
```
*斜体文本*
_斜体文本_
**粗体文本**
__粗体文本__
***粗斜体文本***
___粗斜体文本___
```
效果如下:
*斜体文本*
_斜体文本_
**粗体文本**
__粗体文本__
***粗斜体文本***
___粗斜体文本___
## 分隔线
你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线:
```
***
* * *
*****
- - -
----------
```
效果如下:
第一种
***
第二种
* * *
第三种
*****
第四种
- - -
第五种
----------
## 删除线
如果段落上的文字要添加删除线,只需要在文字的两端加上两个波浪线 **~~** 即可,实例如下:
```
RUNOOB.COM
GOOGLE.COM
~~BAIDU.COM~~
```
显示效果如下所示:
RUNOOB.COM
GOOGLE.COM
~~BAIDU.COM~~
## 下划线
下划线可以通过 HTML 的 \
\ 标签来实现:
```
带下划线文本
```
显示效果如下所示:
带下划线文本
## 脚注
脚注是对文本的补充说明,Markdown 脚注的格式如下:
```
[^要注明的文本]
```
以下实例演示了脚注的用法:
```
创建脚注格式类似这样 [^RUNOOB]。
[^RUNOOB]: 菜鸟教程 -- 学的不仅是技术,更是梦想!!!
```
演示效果如下:
创建脚注格式类似这样 [^RUNOOB]。
[^RUNOOB]: 菜鸟教程 -- 学的不仅是技术,更是梦想!!!
# Markdown 列表
## 有序列表和无序列表
Markdown 支持有序列表和无序列表。
无序列表使用星号(*)、加号(+)或是减号(-)作为列表标记:
```
* 第一项
* 第二项
* 第三项
------ 分割线 ------
+ 第一项
+ 第二项
+ 第三项
------ 分割线 ------
- 第一项
- 第二项
- 第三项
```
显示结果如下:
* 第一项
* 第二项
* 第三项
------ 分割线 ------
+ 第一项
+ 第二项
+ 第三项
------ 分割线 ------
- 第一项
- 第二项
- 第三项
有序列表使用数字并加上 **.** 号来表示,如:
```
1. 第一项
2. 第二项
3. 第三项
```
显示结果如下:
1. 第一项
2. 第二项
3. 第三项
## 列表嵌套
列表嵌套只需在子列表中的选项添加四个空格即可:
```
1. 第一项:
- 第一项嵌套的第一个元素
- 第一项嵌套的第二个元素
2. 第二项:
- 第二项嵌套的第一个元素
- 第二项嵌套的第二个元素
```
显示结果如下:
1. 第一项:
- 第一项嵌套的第一个元素
- 第一项嵌套的第二个元素
2. 第二项:
- 第二项嵌套的第一个元素
- 第二项嵌套的第二个元素
# Markdown 区块
## 区别引用
Markdown 区块引用是在段落开头使用 **>** 符号 ,然后后面紧跟一个**空格**符号:
```
> 区块引用
> 菜鸟教程
> 学的不仅是技术更是梦想
```
效果如下:
> 区块引用
> 菜鸟教程
> 学的不仅是技术更是梦想
## 区块中使用列表
区块中使用列表实例如下:
```
> 区块中使用列表
> 1. 第一项
> 2. 第二项
> + 第一项
> + 第二项
> + 第三项
```
显示结果如下:
> 区块中使用列表
>
> 1. 第一项
> 2. 第二项
>
> + 第一项
> + 第二项
> + 第三项
## 列表中使用区块
如果要在列表项目内放进区块,那么就需要在 **>** 前添加四个空格的缩进。
区块中使用列表实例如下:
```
* 第一项
> 菜鸟教程
> 学的不仅是技术更是梦想
* 第二项
```
显示结果如下:
* 第一项
> 菜鸟教程
> 学的不仅是技术更是梦想
* 第二项
# Markdown 代码
## 单行代码
如果是单行代码或段落上的一个函数或片段的代码可以用反引号把它包起来(**`**),例如:
```
`printf()` 函数
```
显示结果如下:
`printf()` 函数
## 代码区块
代码区块使用三个反引号对**```** 包裹一段代码,并指定一种语言(也可以不指定):
```
```python
class CaseData:
"""这是一个存放测试用例数据的类"""
pass
```
```
显示结果如下:
```python
class CaseData:
"""这是一个存放测试用例数据的类"""
pass
```
# Markdown 链接
## 链接使用方法如下:
```
[链接名称](链接地址)
或者
<链接地址>
```
例如:
这是一个链接 [miki的测试笔记](https://www.cnblogs.com/miki-peng)
直接使用链接地址:
```
```
显示结果如下:
## 高级链接
```
链接也可以用变量来代替,文档末尾附带变量地址:
这个链接用 1 作为网址变量 [Google][1]
这个链接用 runoob 作为网址变量 [Runoob][runoob]
然后在文档的结尾为变量赋值(网址)
[1]: http://www.google.com/
[runoob]: http://www.runoob.com/
```
显示结果如下:
链接也可以用变量来代替,文档末尾附带变量地址:
这个链接用 1 作为网址变量 [Google][1]
这个链接用 runoob 作为网址变量 [Runoob][runoob]
然后在文档的结尾为变量赋值(网址)
[1]: http://www.google.com/
[runoob]: http://www.runoob.com/
# Markdown 图片
Markdown 图片语法格式如下
```
![alt 属性文本](图片地址)
![alt 属性文本](图片地址 "可选标题")
```
- 开头一个感叹号 !
- 接着一个方括号,里面放上图片的替代文字
- 接着一个普通括号,里面放上图片的网址,最后还可以用引号包住并加上选择性的 'title' 属性的文字。
使用实例:
```
![RUNOOB 图标](https://www.cnblogs.com/images/logo_small.gif)
![RUNOOB 图标](https://img.qb5200.com/download-x/20200316/43820.png "RUNOOB")
```
显示结果如下:
![RUNOOB 图标](https://img.qb5200.com/download-x/20200316/43820.png)
![RUNOOB 图标](https://img.qb5200.com/download-x/20200316/43820.png "RUNOOB")
当然,你也可以像网址那样对图片网址使用变量:
```
这个链接用 1 作为网址变量 [RUNOOB][1].
然后在文档的结尾位变量赋值(网址)
[1]: https://img.qb5200.com/download-x/20200316/43820.png
```
显示结果如下:
这个链接用 1 作为网址变量 [RUNOOB][1].
然后在文档的结尾位变量赋值(网址)
[1]: https://img.qb5200.com/download-x/20200316/43820.png
Markdown 还没有办法指定图片的高度与宽度,如果你需要的话,你可以使用普通的 标签。
```
```
显示结果如下:
# Markdown 表格
Markdown 制作表格使用 **|** 来分隔不同的单元格,使用 **-** 来分隔表头和其他行。
语法格式如下:
```
| 表头 | 表头 |
| ---- | ---- |
| 单元格 | 单元格 |
| 单元格 | 单元格 |
```
以上代码显示结果如下:
| 表头 | 表头 |
| ------ | ------ |
| 单元格 | 单元格 |
| 单元格 | 单元格 |
对齐方式
**我们可以设置表格的对齐方式:**
- **-:** 设置内容和标题栏居右对齐。
- **:-** 设置内容和标题栏居左对齐。
- **:-:** 设置内容和标题栏居中对齐。
实例如下:
```
| 左对齐 | 右对齐 | 居中对齐 |
| :-----| ----: | :----: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |
```
以上代码显示结果如下:
| 左对齐 | 右对齐 | 居中对齐 |
| :----- | -----: | :------: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |
# Markdown 高级技巧
## 支持的 HTML 元素
不在 Markdown 涵盖范围之内的标签,都可以直接在文档里面用 HTML 撰写。
目前支持的 HTML 元素有:` ` 等 ,如:
```
使用 Ctrl+Alt+Del 重启电脑
```
输出结果为:
使用 Ctrl+Alt+Del 重启电脑
## 转义
Markdown 使用了很多特殊符号来表示特定的意义,如果需要显示特定的符号则需要使用转义字符,Markdown 使用反斜杠转义特殊字符:
```
**文本加粗**
\*\* 正常显示星号 \*\*
```
输出结果为:
**文本加粗**
\*\* 正常显示星号 \*\*
Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:
```
\ 反斜线
` 反引号
* 星号
_ 下划线
{} 花括号
[] 方括号
() 小括号
# 井字号
+ 加号
- 减号
. 英文句点
! 感叹号
```
# 文字颜色、大小、字体
## 颜色
在markdown中采用如下方式能够控制文字的颜色:
```
文字颜色预览
```
效果如下:
文字颜色预览
颜色名列表:
颜色名 | 十六进制颜色值 | 颜色 |
---|
AliceBlue | #F0F8FF | rgb(240, 248, 255) |
AntiqueWhite | #FAEBD7 | rgb(250, 235, 215) |
Aqua | #00FFFF | rgb(0, 255, 255) |
Aquamarine | #7FFFD4 | rgb(127, 255, 212) |
Azure | #F0FFFF | rgb(240, 255, 255) |
Beige | #F5F5DC | rgb(245, 245, 220) |
Bisque | #FFE4C4 | rgb(255, 228, 196) |
Black | #000000 | rgb(0, 0, 0) |
BlanchedAlmond | #FFEBCD | rgb(255, 235, 205) |
Blue | #0000FF | rgb(0, 0, 255) |
BlueViolet | #8A2BE2 | rgb(138, 43, 226) |
Brown | #A52A2A | rgb(165, 42, 42) |
BurlyWood | #DEB887 | rgb(222, 184, 135) |
CadetBlue | #5F9EA0 | rgb(95, 158, 160) |
Chartreuse | #7FFF00 | rgb(127, 255, 0) |
Chocolate | #D2691E | rgb(210, 105, 30) |
Coral | #FF7F50 | rgb(255, 127, 80) |
CornflowerBlue | #6495ED | rgb(100, 149, 237) |
Cornsilk | #FFF8DC | rgb(255, 248, 220) |
Crimson | #DC143C | rgb(220, 20, 60) |
Cyan | #00FFFF | rgb(0, 255, 255) |
DarkBlue | #00008B | rgb(0, 0, 139) |
DarkCyan | #008B8B | rgb(0, 139, 139) |
DarkGoldenRod | #B8860B | rgb(184, 134, 11) |
DarkGray | #A9A9A9 | rgb(169, 169, 169) |
DarkGreen | #006400 | rgb(0, 100, 0) |
DarkKhaki | #BDB76B | rgb(189, 183, 107) |
DarkMagenta | #8B008B | rgb(139, 0, 139) |
DarkOliveGreen | #556B2F | rgb(85, 107, 47) |
Darkorange | #FF8C00 | rgb(255, 140, 0) |
DarkOrchid | #9932CC | rgb(153, 50, 204) |
DarkRed | #8B0000 | rgb(139, 0, 0) |
DarkSalmon | #E9967A | rgb(233, 150, 122) |
DarkSeaGreen | #8FBC8F | rgb(143, 188, 143) |
DarkSlateBlue | #483D8B | rgb(72, 61, 139) |
DarkSlateGray | #2F4F4F | rgb(47, 79, 79) |
DarkTurquoise | #00CED1 | rgb(0, 206, 209) |
DarkViolet | #9400D3 | rgb(148, 0, 211) |
DeepPink | #FF1493 | rgb(255, 20, 147) |
DeepSkyBlue | #00BFFF | rgb(0, 191, 255) |
DimGray | #696969 | rgb(105, 105, 105) |
DodgerBlue | #1E90FF | rgb(30, 144, 255) |
Feldspar | #D19275 | rgb(209, 146, 117) |
FireBrick | #B22222 | rgb(178, 34, 34) |
FloralWhite | #FFFAF0 | rgb(255, 250, 240) |
ForestGreen | #228B22 | rgb(34, 139, 34) |
Fuchsia | #FF00FF | rgb(255, 0, 255) |
Gainsboro | #DCDCDC | rgb(220, 220, 220) |
GhostWhite | #F8F8FF | rgb(248, 248, 255) |
Gold | #FFD700 | rgb(255, 215, 0) |
GoldenRod | #DAA520 | rgb(218, 165, 32) |
Gray | #808080 | rgb(128, 128, 128) |
Green | #008000 | rgb(0, 128, 0) |
GreenYellow | #ADFF2F | rgb(173, 255, 47) |
HoneyDew | #F0FFF0 | rgb(240, 255, 240) |
HotPink | #FF69B4 | rgb(255, 105, 180) |
IndianRed | #CD5C5C | rgb(205, 92, 92) |
Indigo | #4B0082 | rgb(75, 0, 130) |
Ivory | #FFFFF0 | rgb(255, 255, 240) |
Khaki | #F0E68C | rgb(240, 230, 140) |
Lavender | #E6E6FA | rgb(230, 230, 250) |
LavenderBlush | #FFF0F5 | rgb(255, 240, 245) |
LawnGreen | #7CFC00 | rgb(124, 252, 0) |
LemonChiffon | #FFFACD | rgb(255, 250, 205) |
LightBlue | #ADD8E6 | rgb(173, 216, 230) |
LightCoral | #F08080 | rgb(240, 128, 128) |
LightCyan | #E0FFFF | rgb(224, 255, 255) |
LightGoldenRodYellow | #FAFAD2 | rgb(250, 250, 210) |
LightGrey | #D3D3D3 | rgb(211, 211, 211) |
LightGreen | #90EE90 | rgb(144, 238, 144) |
LightPink | #FFB6C1 | rgb(255, 182, 193) |
LightSalmon | #FFA07A | rgb(255, 160, 122) |
LightSeaGreen | #20B2AA | rgb(32, 178, 170) |
LightSkyBlue | #87CEFA | rgb(135, 206, 250) |
LightSlateBlue | #8470FF | rgb(132, 112, 255) |
LightSlateGray | #778899 | rgb(119, 136, 153) |
LightSteelBlue | #B0C4DE | rgb(176, 196, 222) |
LightYellow | #FFFFE0 | rgb(255, 255, 224) |
Lime | #00FF00 | rgb(0, 255, 0) |
LimeGreen | #32CD32 | rgb(50, 205, 50) |
Linen | #FAF0E6 | rgb(250, 240, 230) |
Magenta | #FF00FF | rgb(255, 0, 255) |
Maroon | #800000 | rgb(128, 0, 0) |
MediumAquaMarine | #66CDAA | rgb(102, 205, 170) |
MediumBlue | #0000CD | rgb(0, 0, 205) |
MediumOrchid | #BA55D3 | rgb(186, 85, 211) |
MediumPurple | #9370D8 | rgb(147, 112, 216) |
MediumSeaGreen | #3CB371 | rgb(60, 179, 113) |
MediumSlateBlue | #7B68EE | rgb(123, 104, 238) |
MediumSpringGreen | #00FA9A | rgb(0, 250, 154) |
MediumTurquoise | #48D1CC | rgb(72, 209, 204) |
MediumVioletRed | #C71585 | rgb(199, 21, 133) |
MidnightBlue | #191970 | rgb(25, 25, 112) |
MintCream | #F5FFFA | rgb(245, 255, 250) |
MistyRose | #FFE4E1 | rgb(255, 228, 225) |
Moccasin | #FFE4B5 | rgb(255, 228, 181) |
NavajoWhite | #FFDEAD | rgb(255, 222, 173) |
Navy | #000080 | rgb(0, 0, 128) |
OldLace | #FDF5E6 | rgb(253, 245, 230) |
Olive | #808000 | rgb(128, 128, 0) |
OliveDrab | #6B8E23 | rgb(107, 142, 35) |
Orange | #FFA500 | rgb(255, 165, 0) |
OrangeRed | #FF4500 | rgb(255, 69, 0) |
Orchid | #DA70D6 | rgb(218, 112, 214) |
PaleGoldenRod | #EEE8AA | rgb(238, 232, 170) |
PaleGreen | #98FB98 | rgb(152, 251, 152) |
PaleTurquoise | #AFEEEE | rgb(175, 238, 238) |
PaleVioletRed | #D87093 | rgb(216, 112, 147) |
PapayaWhip | #FFEFD5 | rgb(255, 239, 213) |
PeachPuff | #FFDAB9 | rgb(255, 218, 185) |
Peru | #CD853F | rgb(205, 133, 63) |
Pink | #FFC0CB | rgb(255, 192, 203) |
Plum | #DDA0DD | rgb(221, 160, 221) |
PowderBlue | #B0E0E6 | rgb(176, 224, 230) |
Purple | #800080 | rgb(128, 0, 128) |
Red | #FF0000 | rgb(255, 0, 0) |
RosyBrown | #BC8F8F | rgb(188, 143, 143) |
RoyalBlue | #4169E1 | rgb(65, 105, 225) |
SaddleBrown | #8B4513 | rgb(139, 69, 19) |
Salmon | #FA8072 | rgb(250, 128, 114) |
SandyBrown | #F4A460 | rgb(244, 164, 96) |
SeaGreen | #2E8B57 | rgb(46, 139, 87) |
SeaShell | #FFF5EE | rgb(255, 245, 238) |
Sienna | #A0522D | rgb(160, 82, 45) |
Silver | #C0C0C0 | rgb(192, 192, 192) |
SkyBlue | #87CEEB | rgb(135, 206, 235) |
SlateBlue | #6A5ACD | rgb(106, 90, 205) |
SlateGray | #708090 | rgb(112, 128, 144) |
Snow | #FFFAFA | rgb(255, 250, 250) |
SpringGreen | #00FF7F | rgb(0, 255, 127) |
SteelBlue | #4682B4 | rgb(70, 130, 180) |
Tan | #D2B48C | rgb(210, 180, 140) |
Teal | #008080 | rgb(0, 128, 128) |
Thistle | #D8BFD8 | rgb(216, 191, 216) |
Tomato | #FF6347 | rgb(255, 99, 71) |
Turquoise | #40E0D0 | rgb(64, 224, 208) |
Violet | #EE82EE | rgb(238, 130, 238) |
VioletRed | #D02090 | rgb(208, 32, 144) |
Wheat | #F5DEB3 | rgb(245, 222, 179) |
White | #FFFFFF | rgb(255, 255, 255) |
WhiteSmoke | #F5F5F5 | rgb(245, 245, 245) |
Yellow | #FFFF00 | rgb(255, 255, 0) |
YellowGreen | #9ACD32 | rgb(154, 205, 50) |
## 字体大小
```
size为1:size为1
size为2:size为2
size为3:size为3
size为4:size为4
size为6:size为6
```
效果如下:
size为1:size为1
size为2:size为2
size为3:size为3
size为4:size为4
size为6:size为6
## 字体
```
我是黑体字
我是宋体字
我是楷体字
我是微软雅黑字
我是fantasy字
我是Helvetica字
```
效果如下:
我是黑体字
我是宋体字
我是楷体字
我是微软雅黑字
我是fantasy字
我是Helvetica字
## 背景色
语法如下:
```
```
效果如下:
# Emoji
emoji使用时复制后面的md代码即可(包括两个冒号),也可以直接复制emoji表情,博客园的md编辑器是支持的。
## People
|