使用 Markdown 编写文章

Markdown 教程

块级元素#

段落与换行#

段落#

HTML 标签：<p>

一个或多个空行会分隔段落。

代码：

1
这是第一段的第一行。
2
这是第一段的第二行。
3

4
这是第二段。

预览：

这是第一段的第一行。这是第一段的第二行。

这是第二段。

换行#

HTML 标签：<br />

在一行末尾添加两个或更多空格即可换行。

代码：

1
这一行结尾有两个空格。
2
所以这里会换行。

预览：

这一行结尾有两个空格。
所以这里会换行。

标题写法#

Markdown 常见两种标题写法：Setext 与 ATX。

Setext 标题#

HTML 标签：<h1>、<h2>

代码：

1
一级标题示例
2
==========
3

4
二级标题示例
5
----------

预览（文字示意）：

一级标题示例二级标题示例

ATX 标题#

HTML 标签：<h1> 到 <h6>

代码：

1
# 一级标题示例
2
## 二级标题示例
3
### 三级标题示例

预览：

这是四级标题预览#

你也可以在标题尾部加井号闭合：

代码：

1
## 二级标题示例 ##

引用块#

HTML 标签：<blockquote>

使用 > 表示引用。

代码：

1
> 这是一个引用段落。
2
> 这是同一段落的下一行。
3
>
4
> 这是引用中的第二段。

预览：

这是一个引用段落。这是同一段落的下一行。

这是引用中的第二段。

引用可以嵌套：

代码：

1
> 第一层引用
2
>
3
> > 第二层引用
4
>
5
> 回到第一层

预览：

第一层引用

第二层引用

回到第一层

列表#

Markdown 支持无序列表与有序列表。

无序列表示例#

HTML 标签：<ul>

代码：

1
- 苹果
2
- 香蕉
3
- 西瓜

预览：

苹果
香蕉
西瓜

有序列表示例#

HTML 标签：<ol>

代码：

1
1. 第一步
2
2. 第二步
3
3. 第三步

预览：

第一步
第二步
第三步

如果以“数字 + 句点”开头，可能会被解析为有序列表：

代码：

1
2026. 这是普通句子。

你可以转义句点：

代码：

1
2026\. 这是普通句子。

列表中的引用#

代码：

1
- 包含引用的列表项
2

3
  > 这是列表项中的引用内容。

列表中的代码块#

代码：

1
- 包含代码块的列表项
2

3
        这里是列表项中的代码块

嵌套列表示例#

代码：

1
- 一级项目 A
2
  - 二级项目 A1
3
  - 二级项目 A2
4
- 一级项目 B

预览：

一级项目 A
- 二级项目 A1
- 二级项目 A2
一级项目 B

代码块#

HTML 标签：<pre>

每行缩进至少 4 个空格（或 1 个制表符）可形成代码块。

代码：

1
这是普通段落。
2

3
    这是缩进代码块。

预览：

这是普通段落。

1
这是缩进代码块。

在代码块里，&、<、> 会按代码内容展示。

代码：

1
    <div class="footer">
2
        版权所有 2026 示例站点
3
    </div>

围栏代码块（扩展）#

你也可以使用三个反引号作为围栏代码块。

代码：

1
```
2
function test() {
3
  console.log("这是围栏代码块示例");
4
}
5
```

语法高亮（扩展）#

围栏代码块可附带语言标识符。

代码：

1
```ruby
2
puts "你好，世界"
3
```

效果如下：

1
puts "你好，世界"

水平分割线#

HTML 标签：<hr />

在单独一行使用 3 个或以上的 -、*、_。

代码：

1
***
2
---
3
___

预览：

表格#

HTML 标签：<table>

这是扩展语法。使用 | 分隔列，使用 - 分隔表头，使用 : 控制对齐。

代码：

1
| 左对齐 | 居中对齐 | 右对齐 |
2
| :----- | :------: | -----: |
3
| 内容 A |  内容 B  |  内容 C |
4
| 内容 D |  内容 E  |  内容 F |

预览：

左对齐	居中对齐	右对齐
内容 A	内容 B	内容 C
内容 D	内容 E	内容 F

行内元素#

链接#

HTML 标签：<a>

Markdown 支持行内链接与引用式链接。

行内链接#

格式：[链接文本](URL "标题")，标题可选。

代码：

1
这是一个[示例链接](https://example.com "示例标题")。
2
这是一个[无标题链接](https://example.net)。

预览：

这是一个示例链接。这是一个无标题链接。

引用式链接#

格式：先定义引用，再使用引用。

代码：

1
[示例]: https://example.com "可选标题"
2

3
这是[引用式链接][示例]。

预览：

这是引用式链接。

强调#

HTML 标签：<em>、<strong>

一个分隔符表示斜体，两个分隔符表示粗体。

代码：

1
*单星号斜体*
2
_单下划线斜体_
3
**双星号粗体**
4
__双下划线粗体__

预览：

斜体示例：单星号斜体
斜体示例：单下划线斜体
粗体示例：双星号粗体
粗体示例：双下划线粗体

行内代码#

HTML 标签：<code>

用反引号包裹行内代码。

代码：

1
请使用 `printf()` 函数输出文本。

预览：

请使用 printf() 函数输出文本。

如果代码中本身包含反引号，可使用多个反引号包裹：

代码：

1
``这里有一个反引号 (`) 字符。``

图片#

HTML 标签：<img />

支持行内图片与引用式图片。

行内图片#

代码：

1
![示例图片](https://s2.loli.net/2024/08/20/5fszgXeOxmL3Wdv.webp "可选标题")

预览：

引用式图片#

代码：

1
[图片引用]: https://s2.loli.net/2024/08/20/5fszgXeOxmL3Wdv.webp "可选标题"
2

3
![示例图片][图片引用]

预览：

删除线#

HTML 标签：<del>

这是扩展语法。

代码：

1
~~这是删除线文本~~

预览：

~~这是删除线文本~~

其他语法#

自动链接#

可用尖括号快速创建 URL 或邮箱链接。

代码：

1
<https://example.com>
2
<name@example.com>

预览：

https://example.com

name@example.com

GFM 还会自动识别标准 URL。

代码：

1
https://github.com/emn178/markdown

预览：

https://github.com/emn178/markdown

反斜杠转义#

反斜杠可转义 Markdown 特殊字符。

代码：

1
\*这是字面意义的星号\*

预览：

*这是字面意义的星号*

常见可转义字符：

代码：

1
\   反斜杠
2
`   反引号
3
*   星号
4
_   下划线
5
{}  花括号
6
[]  方括号
7
()  圆括号
8
#   井号
9
+   加号
10
-   减号
11
.   点号
12
!   感叹号

内联 HTML#

对于 Markdown 未覆盖的标记，可直接写 HTML。

代码：

1
这是普通段落。
2

3
<table>
4
    <tr>
5
        <td>示例单元格</td>
6
    </tr>
7
</table>
8

9
这是另一个普通段落。

预览：