表格
表格是普通的 GFM 管道表格。主题的表格渲染钩子把每张表包进一块可横向滚动的区域，表格下面那一行 {…} 属性决定它是哪一种表：带标题的表、兼容矩阵、参数表、编号表或标签页。合并单元格、排序与筛选不在能力范围内，需要它们的场景请改换呈现方式。
最简例子
不写属性行就是一张普通表。对齐方式照旧来自分隔行，表头单元格是 th scope="col"。
| 组件 | 端口 | 用途 |
|---|---|---|
| PostgreSQL | 5432 | 数据库 |
| Pgbouncer | 6432 | 连接池 |
| Patroni | 8008 | 高可用编排 |
宽表格自己滚动
列太多的表不会把页面撑宽，它在自己的区域里横向滚动。这块区域可以用键盘聚焦：Tab 停入后方向键滚动，无障碍名称是本地化的「可横向滚动的表格」。
| 集群 | 角色 | 版本 | 状态 | 延迟 | 连接数 | 大小 | 备份 |
|---|---|---|---|---|---|---|---|
| pg-meta | primary | 18.1 | running | — | 42 | 12 GB | 2026-08-17 |
| pg-test | replica | 18.1 | streaming | 12 ms | 8 | 12 GB | 2026-08-17 |
表格标题
{caption="…"} 加一个可见的 <caption>，纯文本，不给表编号。
| 条目 | 取值 |
|---|---|
| 主题版本 | v0.6.0 |
| Hugo 下限 | 0.160.1 Extended |
| 许可证 | Apache-2.0 |
兼容矩阵
{.matrix} 用于「行 × 列 = 支持与否」的对照表：第一列成为行表头（th scope="row"），滚动时表头行与第一列吸附不动，其余单元格居中，分隔行另有对齐时以分隔行为准。✅ 与 ❌ 是作者写的字符，主题不解析它们。
| OS / PG | PG18 | PG17 | PG16 | PG15 | PG14 |
|---|---|---|---|---|---|
| EL 9 | ✅ | ✅ | ✅ | ✅ | ✅ |
| EL 8 | ✅ | ✅ | ✅ | ✅ | ✅ |
| Debian 13 | ✅ | ✅ | ✅ | ❌ | ❌ |
| Ubuntu 24.04 | ✅ | ✅ | ✅ | ✅ | ❌ |
用整个画布
{.full-width} 让表格越出正文栏宽，占满文章可用的宽度。适合列多但每列都短的表。
| 语言 | 代码 | 侧栏 | 搜索 | 目录 | 打印 | 状态 |
|---|---|---|---|---|---|---|
| 简体中文 | zh |
✅ | ✅ | ✅ | ✅ | 已审校 |
| English | en |
✅ | ✅ | ✅ | ✅ | 已审校 |
参数表
{.fields} 把表格变成定义列表：第一列是名称，最后一列是说明，中间列是元数据。它是记录配置项、命令参数、API 字段的形态，写法见参数表。
编号表
写书或长手册时给表编号：num 加可选的 #id 与 caption。表格会被包进一个带本地化「表 N.」标签的 <figure>，并注册成 Book 目标，可以被 xref 引用、进入全书表格目录。编号由作者书写，主题不自动计数；id 缺省是 tbl-<num>。
| 隔离级别 | 脏读 | 不可重复读 | 幻读 |
|---|---|---|---|
| 读已提交 | 否 | 是 | 是 |
| 可重复读 | 否 | 否 | 是 |
| 可串行化 | 否 | 否 | 否 |
参见 表 9-1。
表格做成标签页
连着的表格加 {tab="…"} 就组成一组标签页，规则与相邻围栏一致：第一张表上的 group 启用 hash、同步与持久化，此后每张表都要 value。完整规则见标签页。
| 目录 | 内容 |
|---|---|
content/ |
页面 |
data/ |
首页与发布数据 |
| 目录 | 内容 |
|---|---|
assets/ |
SCSS 与图片资源 |
static/ |
原样拷贝的文件 |
输出形态
| 输出 | 呈现 |
|---|---|
| HTML | <div class="td-table-scroll"> 可聚焦滚动区 + <table>；矩阵与全宽是这个包装器上的修饰 class |
| 打印 | 完整表格按页宽排版；包装器仍在，但标成 td-table-scroll--static，不再是可聚焦视口 |
| Markdown | 原样输出源码表格与属性行 |
| RSS | 完整静态表格 |
表格不加载任何脚本。
参数参考
表格下一行的属性行：
.fields, ,- 渲染成定义列表，见参数表
style、on* 与任何其它键都会让构建失败。
限制与常见问题
- 互斥规则：
.fields不能和.matrix、.full-width或num一起用；num与tab互斥；group/value需要tab；meta需要.fields。 - 属性行必须紧贴表格：中间空一行，它就变成正文里一段可见的花括号。Markdown 格式化工具常移动这一行，把它包进
<!-- prettier-ignore-start -->/<!-- prettier-ignore-end -->。 - 没有合并单元格、没有排序、没有筛选：GFM 管道表格能表达的就是全部。需要合并表头的复杂表请拆成两张表或改成一张矩阵。
- 单元格里放不下块内容：多段说明、列表、围栏要用
fields/fieldshortcode。 .matrix的居中由 CSS 实现：分隔行里写了对齐就以分隔行为准。