这是一个测试 Markdown 语法文档
这是一个完整的 Markdown 语法测试文档,涵盖了所有常用的格式和语法规则。无论你是初学者还是想要查阅特定语法,这份文档都能为你提供清晰的示例和说明。
标题
以下 HTML <h1>—<h6> 元素代表六个级别的章节标题。<h1> 是最高级别的标题,而 <h6> 是最低级别。
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
段落
段落是最基本的文本单元。在 Markdown 中,段落由一个或多个连续的文本行组成。相邻的两行文本,如果中间没有空行,会被视为同一个段落内的文本。
如果你想创建一个新的段落,只需要在两段文字之间添加一个空行即可。这样可以保证文档的清晰结构和良好的可读性。
图片
语法

引用
引用元素用于表示引用自其他来源的内容,可选择性地包含引用源信息,引用源信息必须位于 footer 或 cite 元素内,也可以包含内联修改,如注释和缩写。
无引用源的引用
语法
> 代码是写给人看的,只是顺便能在机器上运行。**注意**你可以在引用中使用 _Markdown 语法_。
效果
代码是写给人看的,只是顺便能在机器上运行。注意你可以在引用中使用 Markdown 语法。
有引用源的引用
语法
> 不要通过共享内存来通信,而要通过通信来共享内存。<br> — <cite>Rob Pike[^1]</cite>
效果
不要通过共享内存来通信,而要通过通信来共享内存。
— Rob Pike1
表格
语法
| 斜体 | 粗体 | 代码 |
| ------ | -------- | ------ |
| _斜体_ | **粗体** | `代码` |
效果
| 斜体 | 粗体 | 代码 |
|---|---|---|
| 斜体 | 粗体 | 代码 |
代码块
语法
我们可以使用三个反引号 ``` 在新行中开始代码块,编写代码片段,然后在新行中用三个反引号结束。要启用特定语言的语法高亮,请在第一个三反引号后写上语言名称,例如:html、javascript、css、markdown、typescript、txt、bash
```html
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8" />
<title>HTML5 示例文档</title>
</head>
<body>
<p>测试内容</p>
</body>
</html>
```
效果
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8" />
<title>HTML5 示例文档</title>
</head>
<body>
<p>测试内容</p>
</body>
</html>
列表类型
有序列表
语法
1. 第一项
2. 第二项
3. 第三项
效果
- 第一项
- 第二项
- 第三项
无序列表
语法
- 列表项
- 另一个项目
- 再一个项目
效果
- 列表项
- 另一个项目
- 再一个项目
嵌套列表
语法
- 水果
- 苹果
- 橙子
- 香蕉
- 乳制品
- 牛奶
- 奶酪
效果
- 水果
- 苹果
- 橙子
- 香蕉
- 乳制品
- 牛奶
- 奶酪
其他元素 — abbr、sub、sup、kbd、mark
语法
<abbr title="Graphics Interchange Format">GIF</abbr> 是一种位图图像格式。
H<sub>2</sub>O
X<sup>n</sup> + Y<sup>n</sup> = Z<sup>n</sup>
按下 <kbd>CTRL</kbd> + <kbd>ALT</kbd> + <kbd>Delete</kbd> 来结束会话。
大多数 <mark>蝾螈</mark> 都是夜行动物,以昆虫、蠕虫和其他小生物为食。
效果
GIF 是一种位图图像格式。
H2O
Xn + Yn = Zn
按下 CTRL + ALT + Delete 来结束会话。
大多数 蝾螈 都是夜行动物,以昆虫、蠕虫和其他小生物为食。
文本格式
基础文本样式
这是 **粗体文本** 这是 _斜体文本_ 这是 **_粗斜体文本_** 这是 ~~删除线文本~~ 这是 `行内代码`
效果:
这是 粗体文本 这是 斜体文本 这是 粗斜体文本 这是 删除线文本 这是 行内代码
链接
内联链接
这是一个 [内联链接](https://www.example.com) 这是一个带标题的 [链接](https://www.example.com '链接标题')
效果:
引用式链接
这是一个 [引用式链接][1] 这是另一个 [引用式链接][link-ref]
[1]: https://www.example.com
[link-ref]: https://www.example.com '可选标题'
效果:
分隔线
语法
---
---
---
效果
任务列表
语法
- [x] 已完成的任务
- [ ] 待完成的任务
- [x] ~~已完成并删除的任务~~
- [ ] 另一个待完成任务
- [x] 子任务已完成
- [ ] 子任务待完成
效果
- 已完成的任务
- 待完成的任务
-
已完成并删除的任务 - 另一个待完成任务
- 子任务已完成
- 子任务待完成
转义字符
当你需要显示 Markdown 语法字符本身时,可以使用反斜杠进行转义:
语法
\*这不是斜体\* \*\*这不是粗体\*\* \# 这不是标题 \[这不是链接\](http://example.com)
效果
*这不是斜体* **这不是粗体** # 这不是标题 [这不是链接](http://example.com)
脚注
语法
这里有一个脚注引用[^note1]。
这里是另一个脚注[^note2]。
[^note1]: 这是第一个脚注的内容。
[^note2]: 这是第二个脚注的内容,可以包含多行。
甚至可以包含代码块和其他格式。
效果
这里有一个脚注引用2。
这里是另一个脚注3。
总结
这份文档涵盖了 Markdown 的主要语法特性。掌握这些语法后,你就能够创建结构清晰、格式美观的文档了。记住,Markdown 的哲学是简单易读,所以即使不渲染,原始的 Markdown 文本也应该是易于阅读的。
最后更新:2024年6月19日