Markdown 定义列表
最后更新:2026-10-14
定义列表 常见扩展
扩展语法。术语独占一行,下一行以冒号开头写定义,渲染为 <dl><dt><dd> 结构。写术语表、参数说明、API 文档的利器;GitHub 不支持。
| 所属分组 | GFM 扩展 |
|---|---|
| 规范层级 | 常见扩展 |
| 规范版本 | CommonMark 0.31.2 + GFM |
📝 语法
术语
: 定义内容
▶ 在线示例
在左侧编辑 Markdown,右侧实时看效果
💡 要点
⚠️ 注意 GitHub 与本站默认渲染器不解析,会原样显示;需要时用 HTML <dl> 结构替代。
ℹ️ 说明 一个术语多个定义就是多行冒号开头,语义上生成多个 <dd>。
❓ 常见问题
Q 哪些工具支持?
A Pandoc、PHP Markdown Extra、Jekyll 的 kramdown 等支持。
Q 和表格怎么选?
A 参数少而描述长用定义列表;字段多而整齐用表格。
Q 渲染成什么结构?
A <dl> 包裹,术语是 <dt>,定义是 <dd>,语义清晰利于无障碍。