高级技巧

约 1187 字大约 4 分钟

2025-06-19

支持的 HTML 元素

Markdown 的设计原则是只涵盖纯文本格式的基本排版需求，因此不直接支持的标签可以直接使用 HTML 撰写。

常用 HTML 标签

以下是在 Markdown 中常用的 HTML 标签示例：

标签	说明	示例
`<kbd>`	键盘按键	`<kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd>`
`<b>` / `<strong>`	加粗	`<b>加粗文本</b>`
`<i>` / `<em>`	斜体	`<i>斜体文本</i>`
`<sup>`	上标	`X<sup>2</sup>`
`<sub>`	下标	`H<sub>2</sub>O`
`<br>`	换行	行末加两个空格或直接用 `<br>`
`<mark>`	高亮	`<mark>高亮文本</mark>`
`<del>`	删除线	`<del>已删除文本</del>`
`<details>`	折叠区域	见下方示例

示例

使用 <kbd> 模拟键盘组合键：

使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重启电脑

效果：使用 Ctrl+Alt+Del 重启电脑

使用 <details> 创建可折叠区域：

<details>
<summary>点击查看详细内容</summary>

这里是折叠的内容，可以包含任意 Markdown 格式。

- 列表项一
- 列表项二
</details>

效果：

点击查看详细内容

这里是折叠的内容，可以包含任意 Markdown 格式。

列表项一
列表项二

使用 <mark> 高亮文本：

这是一段<mark>重点强调</mark>的内容

效果：这是一段重点强调的内容

公式

当你需要在文档中插入数学公式时，可以使用两个美元符 $$ 包裹 TeX 或 LaTeX 格式的数学公式。提交后，渲染引擎会根据需要加载 MathJax 对数学公式进行渲染。

行内公式

使用单个 $ 包裹：

质能方程 $E = mc^2$ 是物理学中最著名的公式之一。

效果：质能方程 $E = mc^2$ 是物理学中最著名的公式之一。

独立公式

使用 $$ 包裹，公式居中并放大显示：

$$
\mathbf{V}_1 \times \mathbf{V}_2 = 
\begin{vmatrix}
\mathbf{i} & \mathbf{j} & \mathbf{k} \
\frac{\partial X}{\partial u} &  \frac{\partial Y}{\partial u} & 0 \
\frac{\partial X}{\partial v} &  \frac{\partial Y}{\partial v} & 0 \
\end{vmatrix}
$$

效果：

\mathbf{V}_1 \times \mathbf{V}_2 = \begin{vmatrix} \mathbf{i} & \mathbf{j} & \mathbf{k} \ \frac{\partial X}{\partial u} & \frac{\partial Y}{\partial u} & 0 \ \frac{\partial X}{\partial v} & \frac{\partial Y}{\partial v} & 0 \ \end{vmatrix}

提示：详细的数学公式语法请参考数学公式章节。

特殊符号处理

Markdown 使用反斜杠 \ 来转义语法中用到的特殊符号。以下是需要转义的常见特殊字符：

字符	说明	转义方式
`\`	反斜线	`\`
`	反引号	用双反引号 `` 包裹
`*`	星号	`\*`
`_`	下划线	`\_`
`{}`	花括号	`\{` `\}`
`[]`	方括号	`\[` `\]`
`()`	圆括号	`$` `$`
`#`	井字号	`\#`
`+`	加号	`\+`
`-`	减号	`\-`
`.`	英文句点	`\.`
`!`	感叹号	`\!`
`\|`	管道符	`\|`

示例

\   反斜线
\*  星号
\#  井字号
\|  管道符

效果：

\ 反斜线 * 星号 # 井字号 | 管道符

注意：在内容中输入以上特殊符号时一定要注意转义，否则可能导致内容显示异常或排版混乱。
在表格中显示管道符 | 时，可以通过使用 HTML 实体 | 来解决。

脚注

脚注允许你在文档末尾添加补充说明，而不打断正文的阅读流畅性：

Markdown 支持脚注功能[^1]。

[^1]: 这是脚注的内容，会显示在页面底部。

效果：Markdown 支持脚注功能^[1]。

自定义 ID

可以为标题添加自定义 ID，方便生成目录锚点和跨文档引用：

### 我的标题 {#custom-id}

生成的 HTML 中，该标题的 ID 将为 custom-id，可以通过 #custom-id 进行锚点链接。

任务列表

任务列表（Task List）用于表示待办事项，每个任务项前使用 [ ]（未完成）或 [x]（已完成）：

- [x] 完成项目需求分析
- [x] 编写技术方案
- [ ] 编写核心代码
- [ ] 编写测试用例
- [ ] 代码审查与合并

效果：

高亮文本

使用双等号 == 包裹文字实现高亮效果（部分 Markdown 扩展支持）：

这是一段==非常重要==的内容

效果：这是一段非常重要的内容

定义列表

部分 Markdown 解析器支持定义列表（Definition List）：

术语一
: 定义一

术语二
: 定义二
: 补充说明

效果：

术语一 : 定义一

术语二 : 定义二 : 补充说明

表情符号

许多 Markdown 编辑器支持通过冒号语法插入表情符号：

这太搞笑了！:joy:

效果：这太搞笑了！😂

提示：也可以直接复制粘贴 Unicode 表情符号，兼容性更好。

这是脚注的内容，会显示在页面底部。 ↩︎