本技能用于在 Markdown 中创建和格式化表格,覆盖表格语法、对齐、转义与最佳实践。
用途:撰写文档时插入结构化的表格内容,例如功能对比、API 参考、快捷键列表、更新日志等。
主要能力:基础表格语法使用竖线与短横线定义表头与单元格;列对齐通过冒号控制,:--- 左对齐(默认)、:--: 居中、---: 右对齐;最小语法中竖线与短横线无需对齐,但对齐后源码更易读;单元格内可用 | 转义竖线,支持粗体、斜体、行内代码、链接等行内格式;空单元格可用空格占位。
多行内容:标准 Markdown 表格不支持多行单元格,可用 <br> 标签或改用 HTML 表格。宽表格可放入 overflow-x: auto 的滚动容器,或改写成键值对式的竖排结构。
常见模式:功能对比表、API 参考表、快捷键表、更新日志表。
最佳实践:保持表格简单,内容复杂时考虑其他形式;对齐源码竖线提升可读性;必须包含表头行;转义特殊字符;限制列数;测试不同平台的渲染效果。Markdownlint 相关规则包括 MD055(竖线风格一致)、MD056(列数与表头匹配)、MD058(表格前后留空行)。
替代方案:定义列表(部分解析器支持)、加粗键名的项目符号列表、嵌套列表。
限制:暂未提供关于收费、平台支持范围等方面的明确信息;标准表格不支持多行单元格,需依赖变通方式。