---
title: "Markdown 入门手册"
date: "2022-11-28"
description: "全面的Markdown基础语法入门手册，帮助初学者快速掌握标题、段落、列表、代码块等常用格式化技巧。"
tags:
- markdown
- guide
---
# Markdown 入门手册
::: tip 提示
部分标记语法有多种不同的符号，但是实现的效果一致，文章中只罗列一些方便且较常用的标记符号；
:::
Markdown 是一种轻量级标记语言，它允许人们 “使用易读易写的纯文本格式编写文档，然后转换成有效的 XHTML（或者 HTML）文档”。
## 标题
```markdown
# H1
## H2
### H3
#### H4
```
`#` 的数量代表标题的级别；
## 换行／段落
```markdown
我是第一段
我是第二段
```
在第一行末尾加上两个空格，以实现换行；
```markdown
我是第一段
我是第二段
```
第一行与第二行之间插入空行，以实现切换段落；
## 斜体 / 加粗
```markdown
_斜体_
**加粗**
**_加粗斜体_**
```
段落两端加上对应数量 `*`（星号），即可实现以上三种效果；
## 删除线
```markdown
~~删除线~~
```
段落两端加上波浪线即可实现 ~~删除线~~ 效果；
## 下划线（HTML）
```html
下划线
```
Markdown 语言中没有 下划线 标记，但是可以通过 HTML 的 `` 标记实现下划线效果；
## 有序列表
```markdown
1. 列表一
2. 列表二
1. 子列表一
2. 子列表二
3. 列表三
```
1. 列表一
2. 列表二
1. 子列表一
2. 子列表二
3. 列表三
## 无序列表
```markdown
- 第一种实现符号
- 第二种实现符号
- 嵌套列表
- 第三种实现符号
```
- 第一种实现符号
- 第二种实现符号
- 嵌套列表
- 第三种实现符号
## 任务列表
```markdown
- [ ] 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
## 行内代码
```markdown
全选：`Ctrl + A`
```
全选：`Ctrl + A`
## 代码块
````markdown
```
console.log('Hello world.')
```
````
```
console.log('Hello world.')
```
## 高亮代码块
````markdown
```js
console.log("Hello world.");
```
````
```
console.log("Hello world.");
```
## 链接／邮箱
```markdown
```
```markdown
[Liang's Note](https://in-x.cc/)
```
[Liang's Note](https://in-x.cc/)
## 图片
```markdown
```
## 引用块
```markdown
> 多行引用在末尾添加两个空格换行
> 或在两行之间添加空行
>
> 进行换行
```
> 多行引用在末尾添加两个空格换行
> 或在两行之间添加空行
>
> 进行换行
## 嵌套引用
```markdown
> 时间就是生命，我的朋友
>
> > Yes！
```
> 时间就是生命，我的朋友
>
> > Yes！
## 表格
使用 `|` 分隔单元格，`-` 分隔表头和其他行；
```markdown
| 表头 | 表头 |
| ------ | ------ |
| 单元格 | 单元格 |
| 单元格 | 单元格 |
```
| 表头 | 表头 |
| ------ | ------ |
| 单元格 | 单元格 |
| 单元格 | 单元格 |
单元格对齐：
- `:-` ：左对齐
- `:-:` ：居中
- `-:` ：右对齐
```markdown
| 表头 | 表头 | 表头 |
| :----- | :--: | -----: |
| 左对齐 | 居中 | 右对齐 |
```
| 表头 | 表头 | 表头 |
| :----- | :--: | -----: |
| 左对齐 | 居中 | 右对齐 |
## 分隔符
```markdown
---
---
---
```
---
---
---
## 转义字符
Markdown 的占用了很多常用符号，如：`*` 、`-`、`~` …
如果我们写文档时需要显示这些符号，可以使用转义字符 `\` 将 **标记符号** 转义为 **普通符号** 显示出来；
```markdown
_斜体文本_
\*斜体文本\*
```
_斜体文本_
\*斜体文本\*
```markdown
**加粗文本**
\*\*加粗文本\*\*
```
**加粗文本**
\*\*加粗文本\*\*