MD 语法

基础语法

元素	Markdown 写法	备注
标题	`# H1` `## H2` `### H3`	最多支持 6 级标题
段落	空行分隔	段落前后需要空行
换行	行尾加两个空格，或使用 `\`	强制换行的两种方式
加粗	`加粗文本`
斜体	`斜体文本`
~~删除线~~	`~~要删除的内容~~`
引用	`> 引用内容`	可多级嵌套 `> > 嵌套引用`
有序列表	`1. 第一项`	Tab 键控制缩进
无序列表	`- 第一项`	Tab 键控制缩进
任务列表	`- [ ] 未完成` `- [x] 已完成`	注意空格
行内代码	`代码`	ESC 键下方的反引号
分割线	`---`	三个连续减号

代码块

使用三个反引号包裹代码，可指定语言实现语法高亮：

```python
print("Hello, World!")
```

链接与图片

行内链接

[链接文字](https://example.com)

参考式链接

[链接名称1][1]
[链接名称2][2]

[1]: https://nabin.cn "nabin主页"
[2]: https://thus.chat "thus主页"

图片

![图片描述](image_url)
![图片描述](image_url "悬停提示")

带链接的图片

[![图片描述](image_url)](link_url)

表格

| 列1 | 列2 | 列3 |
| :--- | :---: | ---: |
| 左对齐 | 居中 | 右对齐 |
| 内容 | 内容 | 内容 |

对齐方式：

:--- 左对齐
:---: 居中
---: 右对齐

脚注

这是一段需要解释的文字[^1]，这里还有另一个脚注[^2]

[^1]: 这是第一个脚注的解释内容
[^2]: 这是第二个脚注的解释内容

转义字符

使用反斜杠 \ 转义特殊字符：

\* 显示星号而非斜体
\# 显示井号而非标题

Emoji

:sunny: → ☀️
:smile: → 😄

徽章

使用 shields.io 生成徽章：

[![标签](https://img.shields.io/badge/分类-内容-blue)](https://example.com)

[![使用 Vercel 部署](https://vercel.com/button)](https://vercel.com/import)

[![中国](https://img.shields.io/badge/亚洲-中国-blue?style=for-the-badge)](https://www.fmprc.gov.cn/)

HTML 扩展

Markdown 支持内嵌 HTML，可实现更丰富的功能：

插入视频

<video controls src="video_url" width="900"></video>

插入文档链接

<a target="_blank" href="https://example.com/doc.xlsx">下载文档</a>

折叠内容

<details>
<summary>点击展开 👆</summary>

- 折叠的内容 1
- 折叠的内容 2

</details>

Docsify 扩展语法

以下语法仅在 Docsify 框架中生效：

元素	写法	说明
重要提示	`!> 重要内容`	高亮显示
普通提示	`?> 提示内容`	普通提示框
嵌入网页	`[标题](url ':include :type=iframe')`	嵌入 iframe
图片缩放	`![alt](url ':size=100')`	指定图片尺寸
双链笔记	`[文字](文件.md#锚点)`	文档内引用

基础语法

代码块

链接与图片

行内链接

参考式链接

图片

带链接的图片

表格

脚注

转义字符

Emoji

目录

徽章

HTML 扩展

插入视频

插入文档链接

折叠内容

Docsify 扩展语法

On this page