markdown语法整理
目录
- 1 前言
- 2 markdown是什么
- 3 markdown的语法
-
- 3.1 标题
- 3.2 正文
- 3.3 列表
-
- 3.3.1 有序列表
- 3.3.2 无序列表
- 3.3.3 列表嵌套
- 3.4 区块引用
- 3.5 代码块
- 3.6 字体
-
- 3.6.1 粗体
- 3.6.2 斜体
- 3.6.3 粗斜体
- 3.7 链接
- 3.8 表格
- 3.9 图片
- 3.10 换行
- 3.11 分隔线
- 3.12 删除线
- 3.13 脚注
- 3.14 转义字符
- 四.其他
1 前言
这篇文章会对markdown语法格式进行详细整理，由于内容较多，这篇文章只会给出示例，并不展示效果，具体效果可以自行测试。
这篇文章示例使用vscode编写。
2 markdown是什么
markdown是一种轻量级标记语言，可以使用markdown来编写纯文本格式文档。markdown文件的后缀一般是.md。
3 markdown的语法
3.1 标题
第一种方法
使用#标记标题，#和标题文本之间需要空格，一个#表示一级标题，两个#表示二级标题，以此类推，使用#可以标记六级标题。
示例
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
第二种方法
使用=标记一级标题，-标记二级标题，这种方法只能标记两级标题。
示例
一级标题
==========
二级标题
----------
3.2 正文
正文内容不用特别标记，直接进行编写就可以了。
示例
正文内容
3.3 列表
3.3.1 有序列表
使用序号和.标记有序列表，标记和列表文本之间需要空格。
示例
1. 第一项
2. 第二项
3. 第三项
3.3.2 无序列表
第一种方法
使用+标记列表，+和列表文本之间需要空格。
示例
+ 第一项
+ 第二项
+ 第三项
第二种方法
使用*标记列表，*和列表文本之间需要空格。
示例
* 第一项
* 第二项
* 第三项
第三种方法
使用-标记列表，-和列表文本之间需要空格。
示例
- 第一项
- 第二项
- 第三项
3.3.3 列表嵌套
列表可以嵌套，使用四个空格进行缩进。
示例
1. 第一项
+ 第一项
1. 第一项
2. 第二项
3. 第三项
+ 第二项
* 第一项
* 第二项
* 第三项
+ 第三项
+ 第一项
+ 第二项
+ 第三项
2. 第二项
* 第一项
* 第二项
* 第三项
3. 第三项
- 第一项
- 第二项
- 第三项
3.4 区块引用
使用>标记区块引用。
示例
>区块引用
区块引用可以嵌套，一个>标记第一层，两个>标记第二层，以此类推。
示例
>第一层
>>第二层
>>>第三层
3.5 代码块
第一种方法
使用```（反引号）标记代码块，代码块前后需要用```包裹，并且可以指明所用语言，当然也可以不指明。
示例
```cpp
//main.cpp
#include
int main(int argc, char* argv[])
{
std::cout << "demo" << std::endl;
return 0;
}
```
第二种方法
使用四个空格对每一行代码进行缩进，但是这种方法不能指明语言，当然也可以用注释指明。
示例
//main.cpp
#include
int main(int argc, char* argv[])
{
std::cout << "demo" << std::endl;
return 0;
}
第三种方法
如果是在正文中出现的代码片段，可以用`包裹。
示例
比如代码片段`std::cout << "demo" << std::endl;`
3.6 字体
3.6.1 粗体
第一种方法
使用两个*标记粗体，粗体文本前后需要使用**包裹。
示例
**粗体**
第二种方法
使用两个_标记粗体，粗体文本前后需要使用__包裹。
示例
__粗体__
3.6.2 斜体
第一种方法
使用一个*标记斜体，斜体文本前后需要使用*包裹。
示例
*斜体*
第二种方法
使用一个_标记斜体，斜体文本前后需要使用_包裹。
示例
_斜体_
3.6.3 粗斜体
第一种方法
使用三个*标记粗斜体，粗斜体文本前后需要使用***包裹。
示例
***粗斜体***
第二种方法
使用三个_标记粗斜体，粗斜体文本前后需要使用___包裹。
示例
___粗斜体___
3.7 链接
使用[链接名称](链接地址)标记链接。
示例
[百度](https://www.baidu.com/)
当然也可以直接将链接地址写在正文中。
3.8 表格
使用|标记表格，-标记表头，-:标记右对齐，:-标记左对齐，:-:标记居中对齐。
示例
|表头|表头|表头|
|----|----|----|
|表格|表格|表格|
|表格|表格|表格|
示例
|表头|表头|表头|
|----:|:----|:----:|
|表格|表格|表格|
|表格|表格|表格|
3.9 图片
使用标记图片，图片位置可以是本地目录也可以是链接。
示例
3.10 换行
第一种方法
使用两个空格加上换行表示换行。
示例
第一行
第二行
第二种方法
使用一个空行表示换行。
示例
第一行
第二行
3.11 分隔线
第一种方法。
使用三个及以上_表示分隔线。
示例
__________
第二种方法。
使用三个及以上*表示分隔线。
示例
**********
第三种方法。
使用三个及以上-表示分隔线。
示例
----------
3.12 删除线
使用~~表示删除线，文本内容前后需要使用~~包裹。
示例
~~删除线~~
3.13 脚注
使用[^脚注]标记脚注。
示例
文本[^1]
[^1]: 文本脚注说明
3.14 转义字符
markdown和很多语言一样，也使用\表示转义。
示例
\#
四.其他
1.markdown也可以支持HTML的元素，也可以支持公式，也可以支持流程图，但是有些浏览器或者编辑器并不支持，这篇文章里就不展开了。
2.不同类型的标记之间也可以互相嵌套，比如列表和区块引用可以互相嵌套，比如区块引用嵌套标题，很多都可以进行嵌套的。
示例
+ 第一项
>区块引用
+ 第二项
示例
>区块引用
>+ 第一项
>+ 第二项
示例
>区块引用
># 一级标题
>## 二级标题
欢迎讨论，欢迎指正，欢迎转载。