Markdown语法指南

6/15/2021 OTHER

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

# 标题

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

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

效果如下:

# 一级标题

# 二级标题

# 三级标题

# 四级标题

# 五级标题
# 六级标题

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

这是一级标题
==
这是二级标题
--

效果如下:

# 这是一级标题

# 这是二级标题

# 字体

*我是斜体*
_我是斜体_
**我是粗体**
__我是粗体__
***我是粗斜体***
___我是粗斜体___

效果如下:

我是斜体
我是斜体
我是粗体
我是粗体
我是粗斜体
我是粗斜体

# 线条

~~我是删除~~
<u>这是一条下划线</u>
这是一条分割线
***
这是一条分割线
* * *
这是一条分割线
- - -
这是一条分割线
--------

效果如下:
我是删除
这是一条下划线
这是一条分割线


这是一条分割线


这是一条分割线


这是一条分割线


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

# 列表

# 无序列表

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

* list1
+ list2
- list3
  • list1
  • list2
  • list3

# 有序列表

使用数字 + .来表示

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

# 列表嵌套

1. list1
  - list1-1
  - list1-2
2. list2
  - list2-1
  - list2-2

  1. list1
  • list1-1
  • list1-2
  1. list2
  • list2-1
  • list2-2

# 任务列表

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

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

# 引用

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

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

前言:第一层引用

前言:第二层引用

# 链接

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

百度 (opens new window)

<https://www.baidu.com>

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

# 图片

![alt 属性文本](图片链接)
![占位符](https://iph.href.lu/200x200)

占位符

# 表格

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

|标题1|标题2|标题2
| :- | :-: | -:
|行1列1|行1列2|行1列3
|行2列1|行2列2|行2列3
标题 1 标题 2 标题 2
行 1 列 1 行 1 列 2 行 1 列 3
行 2 列 1 行 2 列 2 行 2 列 3
  • :- 设置文本居左
  • -: 设置文本居右
  • :-: 设置文本居中

# 代码

# 单行代码

`console.log(1)`

效果如下:
console.log(1)

# 代码块

(```)
console.log(1)
(```)

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

console.log(1)

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

console.log(1)
console.log(2)

# 流程图

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

# 兼容 HTML

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

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

效果如下:
orange

使用 kbd 来展示按键:

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

Ctrl+S 来保存文档

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

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

** 正常显示 **

# 注解

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

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

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

[^注解2]:我是注解2
[1]: http://www.baidu.com

效果如下:

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

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

    希望像星光一样闪烁
    文雀