# CSV 转 Typst

粘贴 CSV 或 TSV 行，得到带表头行和横线的已转义 Typst 表格。

CSV 转 Typst 把复制的电子表格行变成 Typst 表格。粘贴这些行、转换，然后把表格粘贴到你的 `.typ` 文件中。

## 何时使用

- 你从电子表格或结果文件中复制了一个区域；
- 数据已经是纯文本，例如一个小的 CSV 导出文件；
- 你想要已转义的 Typst 源码，而不必自己写 `table` 调用。

对于 `.xlsx` 或 `.xls` 工作簿，请使用 [Excel 转 Typst](/docs/tools/excel-to-typst/)。对于 LaTeX 文档，请使用 [Excel 转 LaTeX](/docs/tools/excel-to-latex/)。

## 转换行

1. 打开 **CSV 转 Typst**，或运行 `/csv-to-typst`。
2. 粘贴逗号分隔或制表符分隔的行，或选择**加载示例**。
3. 选择**转换**。
4. 查看结果下方说明中的行数和列数。
5. 复制表格，或保存 `table.typ`。

例如：

```text
Method,Accuracy,Runtime (s)
Baseline,0.82,14.2
Oleafly,0.95,9.8
```

会变成一个三列的 `#table`。第一行是表头，用粗体排版。数字列右对齐，文本列左对齐。横线位于表头上方、表头下方和最后一行下方，没有竖线。

## 表格的行为

- Oleafly 根据第一行检测制表符或逗号。
- 带引号的单元格可以包含逗号、引号和换行。单元格内的换行会变成空格。
- Typst 会当作标记读取的字符，例如 `#`、`*`、`_` 和 `$`，会被转义。
- 转换在你的设备上运行。

:::caution[大小限制]
表格最多可以有 10,000 行和 100 列，单元格文本不超过 2 MB。
:::

在 Typst 文档内部，你可以省去复制粘贴。在编辑器中右键点击，选择**从 CSV/XLSX 导入表格…**。该对话框可以读取 CSV、TSV、XLSX 或 JSON 文件，可添加可选的图注和标签，还能让表格与它的数据文件保持链接，使表格在下次编译时更新。参见[用 Typst 写作](/docs/writing/typst/)。
