markdown

Markdown 语法参考

补充说明

Markdown 是一种轻量级标记语言，以纯文本格式编写文档，易读易写，可转换为 HTML。广泛应用于 README、文档、博客、笔记等场景。

标题

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

段落与换行

段落之间用空行分隔。行尾加两个空格或反斜杠可换行。

这是第一段。

这是第二段。
这是同一行（无换行）。  
这是新行（行尾两个空格）。

强调

*斜体* 或 _斜体_
**粗体** 或 __粗体__
***粗斜体*** 或 ___粗斜体___
~~删除线~~
==高亮==

列表

无序列表

- 项目一
- 项目二
  - 子项目（缩进两个空格）
  - 子项目
- 项目三

有序列表

1. 第一项
2. 第二项
3. 第三项
   1. 子项（缩进三个空格）
   2. 子项

任务列表

- [x] 已完成任务
- [ ] 未完成任务
- [ ] 待办事项

链接

[显示文本](https://example.com)
[带标题的链接](https://example.com "鼠标悬停提示")

# 引用式链接
[文本][引用ID]
[引用ID]: https://example.com

# 自动链接
<https://example.com>
<email@example.com>

图片

![替代文本](https://example.com/image.png)
![带标题的图片](https://example.com/image.png "图片标题")

# 引用式图片
![替代文本][图片ID]
[图片ID]: https://example.com/image.png

代码

# 行内代码
这是 `code` 示例。

# 代码块（指定语言）
\`\`\`python
def hello():
    print("Hello, World!")
\`\`\`

# 代码块（不指定语言）
\`\`\`
echo "Hello"
\`\`\`

引用

> 单层引用
>
> > 嵌套引用
>
> 继续引用

> 引用包含其他元素：
> - 列表项一
> - 列表项二
>
> `代码` 和 **粗体** 均可使用

水平分割线

---
***
___

表格

| 左对齐 | 居中对齐 | 右对齐 |
| :--- | :---: | ---: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |

# 简洁写法
列名一 | 列名二
--- | ---
数据 | 数据

脚注

这是带脚注的文本[^1]。

[^1]: 脚注内容。

转义字符

在特殊字符前加反斜杠可转义：

\*   \\   \`   \~   \_   \{   \}   \[   \]   \(   \)   \#   \+   \-   \.   \!

HTML 混用

Markdown 中可直接嵌入 HTML 标签：

<div style="color: red;">红色文字</div>

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

隐藏内容，支持 Markdown **语法**。

</details>

<table>
  <tr>
    <td>HTML 表格</td>
  </tr>
</table>

Emoji

:smile: :rocket: :+1: :heart: :fire:

锚点

[跳转到标题](#标题)

## 标题 {#custom-id}
[跳转到自定义 ID](#custom-id)

数学公式（LaTeX）

行内公式：$E = mc^2$

块级公式：

$$
\int_a^b f(x)\,dx = F(b) - F(a)
$$

目录（TOC）

[TOC]

# 章节一
内容...

# 章节二
内容...

常见快捷键

编辑器推荐

• Typora — 所见即所得，简洁美观
• VS Code — 内置 Markdown 预览，插件丰富
• Obsidian — 本地知识库，双向链接
• Markdown Here — 浏览器扩展，邮件渲染
• HackMD / CodiMD — 在线协作编辑