# 标准 Markdown

[TOC]

# 目录列表 Table of Contents

[TOC]
1

# 段落

这个文档自身就是使用 Markdown 编写的。
Markdown 允许你通过编写易读、易写的富文本格式,然后很方便就可以转换成有效的 HTML。

# 标题

Markdown 支持两种格式的标题:Setext 和 atx。

Setext-style 标题是用等于号“下划线”(作为一级标题)以及减号作为二级标题。

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

atx-style 标题用 1 - 6 个 # 在一行的开始,对应于标题等级的 1 - 6 级(尾部的 # 是可选的)。

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

# 标签

一般在文首输入 tags 添加标签,categories 添加分类。
备注:分类具有层次性,标签无层次性。

tags:
- Markdown
- 语言

categories:
- 技术
1
2
3
4
5
6

# 待办事项 Todo 列表

使用带有 [ ] 或 [x](未完成或已完成)项的列表语法撰写一个待办事项列表

- [ ] 早起跑步
- [x] 发邮件
1
2

# 斜体或粗体

*斜体*    **粗体**  
_斜体_    __粗体__
1
2

如果 * 和 _ 两边都有空白的话,它们就只会被当成普通的符号

# 网页链接

内联方式(title 是可选的):

This is an [example link](http://example.com/ "Title").
1

引用方式(title 是可选的):

I get 10 times more traffic from [Google][1] than from [Yahoo][2] or [MSN][3].

[1]: http://google.com/        "Google"

[2]: http://search.yahoo.com/  "Yahoo Search"

[3]: http://search.msn.com/    "MSN Search"

[MarkdownX 官方网站][id]。之后,可以在文档的其他任意地方,定义这个链接。  
[id]: http://markdownx.ryeeeeee.com/ "Title"
1
2
3
4
5
6
7
8
9
10

# Email 链接

作者的 email <contact@gmail.com> 链接.
1

# 图片

内联方式(title 是可选的,表示鼠标悬停显示文字):

![alt text](/path/img.jpg "Title")
1

引用方式(title 是可选的):

![alt text][id]  
[id]: /url/to/img.jpg "Title"
1
2

# 列表

行首插入 1 个 *+- 即可生成无序列表。行首插入 1.2.3.、……即可生成有序列表。注意:符号与文本之间必须要有 1 个空格。

有序列表:

1. 列表项 1
2. 列表项 2
1
2

无序列表:

* 列表项 1
* 列表项 2

- 列表项 3
- 列表项 4
1
2
3
4
5

列表项缩进两个空格就可以创建一个嵌套的列表:

1. 列表项 1
    1. 嵌套的列表可以是有序的
    2. 格式和正常的有序、无序列表没有差异
2. 列表项 2
    * 嵌套的列表可以是无序的
        * 这个嵌套的列表项有 4 个空格的缩进,因为它的父列表项自身就带有 2 个空格的缩进
        * 还允许更多层的嵌套
3. 列表项 3
1
2
3
4
5
6
7
8

# 引用

> 段落前面添加 `>` 和空格,就能够形成引用段落。
>
> > 这是嵌套的引用。
1
2
3

# 行内(内联)代码

`内联代码` 使用反引号包含  
你也可以像 `` `这样` `` 转义反引号
1
2

# 代码块

每行缩进 4 个空格或者 1 个 Tab:

    这是代码块。
1

# 水平分割线

三个或更多的 *-

---
***
1
2

# 强制换行

在行尾输入两个空格:

这句话
不会
换行

这句话  
会  
换行
1
2
3
4
5
6
7

# 脚注(footnote)

hello[^1]

[^1]: hi
1
2
3

# GitHub Flavored Markdown

# 链接自动展示

你可以直接输入链接地址,它可以直接识别这个链接。

http://markdownx.ryeeeeee.com
1

# 删除线

通过两个波浪号将字符包含:

~~错误的文本~~
1

# 围栏式代码块

标准的 Markdown 通过每行开头的 4 个空格将文本转换成代码块,而 GFM 支持围栏式代码块。只要将代码用 ``` 包含起来即可,不需要 4 个空格的缩进。

# 表格

这是个简单的表格:

First Header | Second Header | Third Header
------------ | ------------- | ------------
Content Cell | Content Cell  | Content Cell
Content Cell | Content Cell  | Content Cell
1
2
3
4

出于美观的考虑,可以把两端都包围起来:

| First Header | Second Header | Third Header |
| ------------ | ------------- | ------------ |
| Content Cell | Content Cell  | Content Cell |
| Content Cell | Content Cell  | Content Cell |
1
2
3
4

通过在标题分割行添加冒号 :,你可以定义表格单元的对齐格式:向左对齐、居中和向右对齐:

| First Header | Second Header | Third Header |
| :----------- | :-----------: | -----------: |
| Left         |    Center     |        Right |
| Left         |    Center     |        Right |
1
2
3
4

表格内使用 HTML 的 <br> 标签进行换行

Updated at: 2026-04-17 00:40:51