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>,语义清晰利于无障碍。

📚 相关条目

表格GFM 扩展 行内 HTMLCommonMark 核心
Web-Tutorial.com

Web-Tutorial 技术团队

由多位开发者共同维护的编程教程平台。每篇教程由对应领域的开发者编写和审核,确保内容准确可靠。如发现任何问题,欢迎向我们反馈。

100%

🙏 帮我们做得更好

我们是刚上线的编程教程站,几个人的小团队,精力有限。页面虽经检查,难免还有疏漏——链接失效、排版错乱、内容有误、语言生硬……

如果您发现了,麻烦告诉我们,我们会在收到反馈后第一时间进行修复,再次感谢您的光临 🙏