Quarto 包含许多功能,旨在简化 Markdown 表格的编写和自定义,包括:
- 指定列对齐和宽度。
- 提供标题、子标题和交叉引用。
- 从可执行代码单元动态生成表格。
本文概述了 Quarto 中的这些功能。有关 Quarto 用于编写表格的所有功能的更多详细信息,请参阅 表格。
Markdown 表格
最常用的 Markdown 表格称为管道表格。管道表格支持指定每列的对齐方式以及标题。例如:
| 默认 | 左对齐 | 右对齐 | 居中 |
|---------|:-----|------:|:------:|
| 12 | 12 | 12 | 12 |
| 123 | 123 | 123 | 123 |
| 1 | 1 | 1 | 1 |
: 管道表格语法演示
以下是渲染为 HTML 的表格:
默认 | 左对齐 | 右对齐 | 居中 |
---|---|---|---|
12 | 12 | 12 | 12 |
123 | 123 | 123 | 123 |
1 | 1 | 1 | 1 |
标题位置
默认情况下,表格标题位于表格上方。您可以使用 tbl-cap-location
选项修改此行为。例如:
---
tbl-cap-location: top
---
显式列宽
除了使用标准管道表格语法表示列宽外,您还可以使用 tbl-colwidths
属性或文档级选项显式指定列宽。对于单个 Markdown 表格,在标题后添加属性。例如:
| 水果 | 价格 |
|--------|--------:
| 苹果 | 2.05 |
| 梨 | 1.37 |
| 橙子 | 3.09 |
[75,25]"} : 水果价格 {tbl-colwidths="
请注意,此选项在顶层指定,以便可以由 PDF 和 HTML 格式共享。如果您仅针对单一格式,可以将其与其他 format
特定选项放在一起。
标题位置的有效值包括:
值 | 描述 |
---|---|
top |
将标题置于表格上方。 |
bottom |
将标题置于表格下方。 |
margin |
将标题置于页边距中。 |
计算
上述所有选项均适用于由可执行代码单元生成的表格。例如,这里我们将 tbl-cap
、tbl-colwidths
和 tbl-caption-location
选项应用于代码单元:
```{r}
#| tbl-cap: "汽车"
#| tbl-colwidths: [60,40]
#| tbl-cap-location: margin
library(knitr)
kable(head(cars))
```
除了上述内容,重点介绍了在 Markdown 中编写管道表格时 Quarto 的一些功能外,您还可以使用网格语法编写表格。您可以查看 文档 了解更多详细信息。