# Markdown文档教程 💚
# 基础语法
# 标题
# h1
## h2
### h3
#### h4
##### h5
###### h6
2
3
4
5
6
除此之外，Markdown还支持另外一种形式的标题展示形式，其类似于 Setext 标记语言的表现形式，使用下划线进行文本大小的控制
这是一级标题
===
这是二级标题
---
2
3
4
# 段落及区块引用
Markdown其实就是一种易于编写的普通文本，只不过加入了部分渲染文本的标签而已。其最终依然会转换为html标签，因此使用Markdown分段非常简单，前后至少保留一个空行即可。
# 字体
使用*或_包裹即可。使用单一符号标记的效果是斜体，使用两个符号标记的效果是加粗
*这里是斜体*
_这里是斜体_
**这里是加粗**
__这里是加粗__
***这里是加粗斜体***
___这里是加粗斜体___
~~这是要删除的文字~~
2
3
4
5
6
7
8
9
10
效果:
这里是斜体 这里是斜体
这里是加粗 这里是加粗
这里是加粗斜体 这里是加粗斜体
这是要删除的文字
# 插入链接或者图片
[点击跳转至百度](http://www.baidu.com)
2
效果:
# 列表
无序列表使用*或+或-标识
提示
一定要与后面的字加空格
有序列表使用数字加.标识，例如：1.
* 前端
* 后端
+ 前端
+ 后端
- 前端
- 后端
1. 前端
2. 后端
* 总目录
* 一级目录
* 二级目录
* 三级目录
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
效果:
- 前端
- 后端
- 前端
- 后端
- 前端
- 后端
- 前端
- 后端
- 总目录
- 一级目录
- 二级目录
- 三级目录
- 二级目录
- 一级目录
# 列表的注意事项
- 如果在单一列表项中包含了多个段落，为了保证渲染正常，*与段落首字母之间必须保留四个空格
* 前端
javascript
* 后端
java
2
3
4
5
效果:
- 前端
javascript
- 后端 java
- 如果在列表中加入了区块引用，区域引用标记符也需要缩进4个空格
* 段落一
> 区块标记一
2
- 段落一
区块标记一
提示
记住一个原则，如果在和列表配合使用的时候出现了问题，就缩进一次，四个空格或者一个制表符代表一次缩进。如果一次缩进没有解决问题，那就两次。
# 分隔线
三个或三个以上的（_或*）都可以
---
***
2
效果:
# 高亮
> 这段文字将被高亮显示...
效果:
这段文字将被高亮显示...
# 高级语法
# 插入代码块
单行代码：代码之间分别用一个反引号包起来
`代码内容`
效果:
代码内容
代码块：代码之间分别用三个反引号包起来，且两边的反引号单独占一行
(```)
function fun(){
echo "这是一句非常牛逼的代码";
}
(```)
2
3
4
5
提示
实际用途中是没有()的，上面仅是演示
效果:
function fun(){
echo "这是一句非常牛逼的代码";
}
2
3
# 插入表格
表头|条目一|条目二
:---:|:---:|:---:
项目|项目一|项目二
2
3
效果:
| 表头 | 条目一 | 条目二 |
|---|---|---|
| 项目 | 项目一 | 项目二 |
提示
三个短斜杠左右的冒号用于控制对齐方式，只放置左边冒号表示文字居左，只放置右边冒号表示文字居右，如果两边都放置冒号表示文字居中。
# 特殊符号处理
Markdown使用反斜杠\插入语法中用到的特殊符号。在Markdown中，主要有以下几种特殊符号需要处理：
\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号
2
3
4
5
6
7
8
9
10
11
12
提示
在内容中输入以上特殊符号的时候一定要注意转义，否则将导致内容显示不全，甚至排版混乱。
# Markdown拓展
# Emoji
:tada: :100: :blush: :smirk:
效果:
🎉 💯 😊 😏
想要更多表情包可以查看:markdownEmoji
# 自定义容器
::: tip
This is a tip
:::
::: warning
This is a warning
:::
::: danger
This is a dangerous warning
:::
::: danger STOP
Danger zone, do not proceed
:::
2
3
4
5
6
7
8
9
10
11
12
13
14
15
效果:
TIP
This is a tip
WARNING
This is a warning
WARNING
This is a dangerous warning
STOP
Danger zone, do not proceed
# 目录
[[toc]]
效果: