Markdown 使用说明

前言

Markdown 是一种轻量级标记语言，创始人为約翰・格魯伯（英语：John Gruber）;

它允许人们 “使用易读易写的纯文本格式编写文档，然后转换成有效的 XHTML（或者 HTML）文档”；

这种语言吸收了很多在电子邮件中已有的纯文本标记的特性；

—— 维基百科

Markdown 的部分标记有几种不同的符号，但是实现的效果都是相同的，所以文章中每种实现的效果我只写一种符号，一般都是方便且较常用的标记符号；

标题

# H1
## H2
### H3
#### H4

# 的数量代表标题的级别；

换行／段落

我是第一段  
我是第二段

在第一行末尾加上两个空格，以实现换行；

我是第一段

我是第二段

第一行与第二行之间插入空行，以实现切换段落；

斜体 / 加粗

*斜体*
**加粗**
***加粗斜体***

段落两端加上对应数量 *（星号），即可实现以上三种效果；

删除线

~~删除线~~

段落两端加上 ~~ 即可实现 ~~删除线~~ 效果；

下划线（HTML）

下划线

Markdown 语言中没有下划线标记，但是可以通过 HTML 的标记实现下划线效果；

有序列表

1. 列表一
2. 列表二
   1. 子列表一
   2. 子列表二
3. 列表三

列表一
列表二
1. 子列表一
2. 子列表二
列表三

无序列表

- 第一种实现符号
- 第二种实现符号
   - 嵌套列表
- 第三种实现符号

第一种实现符号
第二种实现符号
- 嵌套列表
第三种实现符号

任务列表

- [ ] TODO 1
- [ ] TODO 2
   - [ ] TODO 2.1
   - [x] TODO 2.2
- [x] TODO 3

[ ] TODO 1
[ ] TODO 2
- [ ] TODO 2.1
- [x] TODO 2.2
[x] TODO 3

行内代码

全选：`Ctrl + A`

全选：Ctrl + A

代码块

\```
我是代码块（去掉开头转义符号）
\```

我是代码块

高亮代码块

\```javascript
consolo.log('在行首 ``` 后加上代码语言的名字');
consolo.log('即可实现对应的代码高亮效果')
\```

consolo.log('在行首 ``` 后加上代码语言的名字');
consolo.log('即可实现对应的代码高亮效果')

链接／邮箱

mailto:[email protected]
https://in-x.cc/

[Liang's Note](https://in-x.cc/)

Liang's Note

图片

![我的头像](https://www.github.com/liang-n.png/)

引用块

> 多行引用如果需要换行
> 可在两行之间添加空行
>
> 或在换行前的行末添加两个空格

多行引用如果需要换行
可在两行之间添加空行
或在换行前的行末添加两个空格

嵌套引用

> 时间就是生命，我的朋友
>> Yes！

时间就是生命，我的朋友

Yes！

表格

使用 | 分隔单元格，- 分隔表头和其他行；

| 表头   | 表头   |
| ------ | ------ |
| 单元格 | 单元格 |
| 单元格 | 单元格 |

表头	表头
单元格	单元格
单元格	单元格

单元格对齐：

:- ：左对齐
:-: ：居中
-: ：右对齐

| 表头   | 表头  |   表头 |
| :----- | :---: | -----: |
| 左对齐 | 居中  | 右对齐 |

表头	表头	表头
左对齐	居中	右对齐

分隔符

---

转义字符

Markdown 的占用了很多常用符号，如：* 、-、~ …

如果我们写文档时需要显示这些符号，可以使用转义字符 \ 将 标记符号 转义为 普通符号 显示出来；

*斜体文本*
\*斜体文本\*

斜体文本
*斜体文本*

**加粗文本**
\*\*加粗文本\*\*

加粗文本
**加粗文本**