Markdown 语法指南

3/1/2022 Other

Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档

# 标题

使用#号可表示 1-6 级标题,一级标题对应一个#号,二级标题对应两个#号,以此类推。

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
1
2
3
4
5
6

效果如下:

# 一级标题

# 二级标题

# 三级标题

# 四级标题

# 五级标题
# 六级标题

也可以使用==来表示 1 级标题,__来表示 2 级标题

这是一级标题
==
这是二级标题
--
1
2
3
4

效果如下:

# 一级标题

# 二级标题

# 字体

*我是斜体*
_我是斜体_
**我是粗体**
__我是粗体__
***我是粗斜体***
___我是粗斜体___
1
2
3
4
5
6

我是斜体

我是斜体

我是粗体

我是粗体

我是粗斜体

我是粗斜体

# 线条

~~我是删除~~
<u>这是一条下划线</u>
这是一条分割线
***
这是一条分割线
* * *
这是一条分割线
- - -
这是一条分割线
--------
1
2
3
4
5
6
7
8
9
10

我是删除

这是一条下划线

这是一条分割线


这是一条分割线


这是一条分割线


# 这是一条分割线

注意:三个或三个以上的-*

# 列表

# 无序列表

使用+, -, * 其中任何一个作为标记

* list1
+ list2
- list3
1
2
3
  • list1
  • list2
  • list3

# 有序列表

使用数字 + .来表示

1. list1
2. list2
3. list3
1
2
3
  1. list1
  2. list2
  3. list3

# 列表嵌套

1. list1
  - list1-1
  - list1-2
2. list2
  - list2-1
  - list2-2
1
2
3
4
5
6
  1. list1
  • list1-1
  • list1-2
  1. list2
  • list2-1
  • list2-2

# 任务列表

注:此种写法在 vuepress 中无效,可以使用原生的复选框代替

- [ ] 吃饭
- [x] 睡觉  //打x的表示已完成
- [ ] 打豆豆
1
2
3
  • [ ] 吃饭
  • [x] 睡觉 //打 x 的表示已完成
  • [ ] 打豆豆
<label><input type="checkbox">吃饭</label>
<label><input type="checkbox" checked>睡觉</label>
<label><input type="checkbox">打豆豆</label>
1
2
3

# 引用

可以无限引用,但是没什么太大的意义

> 前言:第一层引用
>> 前言:第二层引用
1
2

前言:第一层引用

前言:第二层引用

# 链接

[百度](https://www.baidu.com)
1

百度 (opens new window)

<https://www.baidu.com>
1

https://www.baidu.com (opens new window)

# 图片

![alt 属性文本](图片链接)
![占位符](https://iph.href.lu/200x200)	//在线图片
![占位符](/achievements-icon.png "测试")	//本地图片
1
2
3

占位符 占位符

# 表格

Markdown 使用 | 来分隔不同单元格,使用 - 来分隔表头和主体

|标题1|标题2|标题2
| :- | :-: | -:
|行1列1|行1列2|行1列3
|行2列1|行2列2|行2列3
1
2
3
4
标题 1 标题 2 标题 2
行 1 列 1 行 1 列 2 行 1 列 3
行 2 列 1 行 2 列 2 行 2 列 3

# 代码

# 单行代码

(```)
console.log(1)
(```)
1
2
3

这里在几个平台测试了一下,发现有的能显示,有的不能显示,所以这里在 ```外面包裹一层()只用于展示使用 效果如下:

console.log(1)
1

或者直接使用 4 个空格,也是可以展示一个代码片段

console.log(1)
1

# 流程图

Markdown 还支持流程图或甘特图之类的.但是因为不同的平台对其支持都是不同的,有的支持,有的不支持,因此就不展示流程图的代码了。

# 兼容 HTML

Markdown 的目标是成为一种适用于网络的书写语言.它的标签较少,只对应了 HTML 中的一部分.不在其覆盖范围内的,我们可以使用 html 标签来书写.(貌似也有的平台是不支持的)

<span style="color:orange;">orange</span>
1

效果如下:

orange

使用kbd来展示按键:

<kbd>Ctrl</kbd>+<kbd>S</kbd>
1

Ctrl+S来保存文档

使用反斜杠转义特殊字符:

\*\* 正常显示 \*\*
1

** 正常显示 **

# 注解

使用[^]来定义注解:(vuepress中无效)

我是一个注解[^注解1]
我也是一个注解[^注解2]
去[百度][1]

[^注解1]:我是注解1

[^注解2]:我是注解2
[1]: http://www.baidu.com
1
2
3
4
5
6
7
8

效果如下:

我是一个注解[^注解1]
我也是一个注解[^注解2]
Google (opens new window)

[^注解1]: 我是注解 1 [^注解2]: 我是注解 2

Last Updated: 3/5/2022, 4:30:55 PM