定义列表 #

概述 #

定义列表用于展示术语及其定义，是部分 Markdown 扩展语法。

PHP Markdown Extra 语法 #

markdown 
术语
: 定义内容

另一个术语
: 另一个定义

多个定义 #

markdown 
术语
: 第一个定义
: 第二个定义

多行定义 #

markdown 
术语
: 第一行定义
  第二行定义
  第三行定义

实际应用 #

术语表 #

markdown 
HTML
: HyperText Markup Language，超文本标记语言

CSS
: Cascading Style Sheets，层叠样式表

JavaScript
: 一种脚本语言，用于实现网页交互

API 术语 #

markdown 
GET
: 获取资源

POST
: 创建资源

PUT
: 更新资源

DELETE
: 删除资源

配置说明 #

markdown 
port
: 服务监听端口，默认 3000

host
: 服务绑定地址，默认 localhost

debug
: 是否开启调试模式，默认 false

兼容性问题 #

原生 Markdown 不支持 #

标准 Markdown 不支持定义列表语法。

解决方案 #

使用 HTML 定义列表：

markdown 
<dl>
  <dt>术语</dt>
  <dd>定义内容</dd>
  
  <dt>另一个术语</dt>
  <dd>另一个定义</dd>
</dl>

使用表格替代 #

markdown 
| 术语 | 定义 |
|------|------|
| HTML | 超文本标记语言 |
| CSS | 层叠样式表 |
| JavaScript | 脚本语言 |

使用列表替代 #

markdown 
- **HTML** - HyperText Markup Language，超文本标记语言
- **CSS** - Cascading Style Sheets，层叠样式表
- **JavaScript** - 一种脚本语言，用于实现网页交互

支持的平台 #

平台 支持情况
PHP Markdown Extra 支持
Pandoc 支持
Obsidian 部分支持
GitHub 不支持
GitLab 不支持

最佳实践 #

1. 使用 HTML 确保兼容 #

markdown 
<dl>
  <dt>术语</dt>
  <dd>定义</dd>
</dl>

2. 使用表格展示术语 #

markdown 
| 术语 | 说明 |
|------|------|
| API | 应用程序接口 |
| SDK | 软件开发工具包 |

3. 使用列表简化 #

markdown 
- **术语1**：定义1
- **术语2**：定义2

下一步 #

继续学习 任务列表扩展！

最后更新：2026-03-24