Markdown 语法完整教程与测试

本文覆盖主题启用的全部 16 个 markdown-it 插件，每项含用途、语法、示例、实现效果，供自动化测试断言。

1. emoji 表情（markdown-it-emoji）

用途

在 Markdown 中直接使用 emoji 短代码。

语法

:smile: :heart: :rocket:

示例

😄 微笑 ｜ ❤️ 爱心 ｜ 🚀 火箭 ｜ 👍 点赞

实现效果

短代码渲染为彩色 emoji。

测试断言：页面含 emoji 渲染标记（<span class="emoji"> 或直接 emoji 字符）。

2. 缩写 abbr（markdown-it-abbr）

用途

定义缩写词，悬停显示全称。

语法

*[HTML]: Hyper Text Markup Language
HTML 是网页的标准语言。

示例

W3C 制定 Web 标准。

实现效果

缩写词带虚线下划线，悬停显示全称。

测试断言：页面含 <abbr 标记。

3. 脚注 footnote（markdown-it-footnote）

用途

文末脚注引用。

语法

这里是正文[^1]。

[^1]: 这是脚注内容。

示例

Hexo 是一个快速静态博客框架^[1]。

实现效果

正文上标数字，点击跳转文末脚注。

测试断言：页面含 footnote 相关标记（<sup 或 footnotes）。

4. 插入文本 ins（markdown-it-ins）

用途

++插入文本++ 渲染为下划线插入效果。

语法

这是 ++插入的内容++。

示例

本次更新 新增了暗色模式 支持。

实现效果

插入文本带下划线（类似修订标记）。

测试断言：页面含 <ins 标记。

5. 下标 sub（markdown-it-sub）

用途

~下标~ 渲染为下标。

语法

H~2~O 是水的化学式。

示例

CO₂ 是二氧化碳。

实现效果

文本渲染为下标。

测试断言：页面含 <sub 标记。

6. 上标 sup（markdown-it-sup）

用途

^上标^ 渲染为上标。

语法

E=mc^2^ 是质能方程。

示例

2¹⁰ = 1024。

实现效果

文本渲染为上标。

测试断言：页面含 <sup 标记。

7. 高亮 mark（markdown-it-mark）

用途

==高亮== 渲染为荧光笔高亮。

语法

这是 ==重点内容==。

示例

请特别注意 密码安全。

实现效果

文本带高亮背景色。

测试断言：页面含 <mark 标记。

8. 任务列表 task-checkbox（markdown-it-task-checkbox）

用途

渲染可勾选的任务列表。

语法

- [x] 已完成任务
- [ ] 未完成任务

示例

• 主题测试文章创建
• 自动化测试脚本
• 视觉回归验证

实现效果

复选框 + 已完成任务带删除线。

测试断言：页面含 task-list-item 或 checkbox 标记。

9. 表格增强 multimd-table（markdown-it-multimd-table）

用途

增强表格语法：单元格合并、多行表头、对齐等。

语法

| 左对齐 | 居中 | 右对齐 |
| :----- | :--: | -----: |
| a | b | c |

示例

实现效果

表格正确渲染，对齐生效。

测试断言：页面含 <table 标记。

10. 图片尺寸 imsize（markdown-it-imsize）

用途

用 =宽x高 控制图片显示尺寸。

语法

![图片](url =300x200)

示例

实现效果

图片按指定尺寸显示。

测试断言：页面含 img 且带尺寸属性。

11. 容器 container（markdown-it-container）

用途

::: 类型 渲染自定义容器。

语法

::: warning
警示内容
:::

示例

::: warning
这是 warning 容器。
:::

::: tip
这是 tip 容器。
:::

实现效果

容器带色条和淡色背景（映射到 note 样式）。

测试断言：页面含 note warning 容器标记。

12. 定义列表 deflist（markdown-it-deflist）

用途

渲染定义列表（术语 + 描述）。

语法

术语
: 定义描述

示例

Hexo

快速、简洁且高效的博客框架。

基于 Node.js 编写。

实现效果

术语加粗，描述缩进。

测试断言：页面含 <dl / <dt / <dd 标记。

13. 数学公式 mathjax3（markdown-it-mathjax3）

用途

渲染 LaTeX 数学公式（内联 + 块级）。

语法

内联：$E=mc^2$
块级：
$$
\int_0^1 x^2 dx = \frac{1}{3}
$$

示例

内联公式： $E=m{c}^2$

块级公式：

实现效果

公式渲染为 SVG 数学符号。

测试断言：页面含 math 渲染标记（SVG 或 math 容器）。

14. 中文排版 cjk-breaks（markdown-it-cjk-breaks）

用途

中文行内换行优化（避免中英文间错误断行）。

语法

这是中文测试内容，混合English和中文。

实现效果

中英文混排行内不错误断行。

测试断言：中文文本正常渲染。

15. 任务列表/表格综合（multimd-table 增强）

用途

多行表头 + 单元格合并等高级表格。

语法

| 表头1 | 表头2 |
| ----- | ----- |
| 单元格 | 单元格 |

示例

实现效果

增强表格正确渲染。

测试断言：页面含 <table 标记（≥2 个表格）。

16. 综合测试（多插件组合）

示例

任务清单（task-checkbox）：

• emoji 正常：✅
• 缩写正常：[API]: Application Programming Interface API
• 数学正常： $a^2+b^2=c^2$

定义列表（deflist）：
Markdown
: 轻量级标记语言。
: 由 John Gruber 发明。

脚注（footnote）：主题测试文章共 4 篇^[2]。

实现效果

多插件组合在同一页面正常工作。

测试断言：页面含多类标记组合。

附：markdown-it 插件速查表