自定义表格输出

使用 Quarto 编写和自定义 Markdown 表格

本文概述了 Quarto 中的这些功能。有关 Quarto 用于编写表格的所有功能的更多详细信息,请参阅 表格

功能
编写
表格
Author

JJ Allaire

Published

February 15, 2022

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   |

: 水果价格 {tbl-colwidths="[75,25]"}

请注意,此选项在顶层指定,以便可以由 PDF 和 HTML 格式共享。如果您仅针对单一格式,可以将其与其他 format 特定选项放在一起。

标题位置的有效值包括:

描述
top 将标题置于表格上方。
bottom 将标题置于表格下方。
margin 将标题置于页边距中。

计算

上述所有选项均适用于由可执行代码单元生成的表格。例如,这里我们将 tbl-captbl-colwidthstbl-caption-location 选项应用于代码单元:

```{r}
#| tbl-cap: "汽车"
#| tbl-colwidths: [60,40]
#| tbl-cap-location: margin

library(knitr)
kable(head(cars))
```

除了上述内容,重点介绍了在 Markdown 中编写管道表格时 Quarto 的一些功能外,您还可以使用网格语法编写表格。您可以查看 文档 了解更多详细信息。

Subscribe

Enjoy this blog? Get notified of new posts by email: