这是一个测试 Markdown 语法文档

完整的 Markdown 语法参考指南,涵盖从基础到高级的所有常用格式和技巧,帮助你快速掌握 Markdown 写作。
这是一个测试 Markdown 语法文档

这是一个完整的 Markdown 语法测试文档,涵盖了所有常用的格式和语法规则。无论你是初学者还是想要查阅特定语法,这份文档都能为你提供清晰的示例和说明。

标题

以下 HTML <h1><h6> 元素代表六个级别的章节标题。<h1> 是最高级别的标题,而 <h6> 是最低级别。

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

段落

段落是最基本的文本单元。在 Markdown 中,段落由一个或多个连续的文本行组成。相邻的两行文本,如果中间没有空行,会被视为同一个段落内的文本。

如果你想创建一个新的段落,只需要在两段文字之间添加一个空行即可。这样可以保证文档的清晰结构和良好的可读性。

图片

语法

![替代文本](./完整/或/相对/图片路径)

引用

引用元素用于表示引用自其他来源的内容,可选择性地包含引用源信息,引用源信息必须位于 footercite 元素内,也可以包含内联修改,如注释和缩写。

无引用源的引用

语法

> 代码是写给人看的,只是顺便能在机器上运行。**注意**你可以在引用中使用 _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. 第三项

效果

  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日

Footnotes

  1. 以上引用摘自 Rob Pike 在 2015 年 11 月 18 日 Gopherfest 期间的演讲

  2. 这是第一个脚注的内容。

  3. 这是第二个脚注的内容,可以包含多行。

    甚至可以包含代码块和其他格式。