# Excel 转 Typst

把 Excel、CSV 或 TSV 文件的第一个工作表变成已转义的 Typst 表格。

Excel 转 Typst 把电子表格中已经完成的表格搬进 Typst 文档。它读取文件、转义每个单元格，并为你写好 `#table` 调用。

## 最适合的场景

适合干净的矩形表格：结果、汇总统计，或在电子表格中准备好的对比表。第一行会成为粗体表头。

如果这些行已经在剪贴板里，[CSV 转 Typst](/docs/tools/csv-to-typst/)接受粘贴的文本。对于 LaTeX 文档，请使用 [Excel 转 LaTeX](/docs/tools/excel-to-latex/)。图表和曲线图请保留为图片。

## 转换工作表

1. 打开 **Excel 转 Typst**，或运行 `/excel-to-typst`。
2. 选择一个 `.xlsx`、`.xls`、`.csv` 或 `.tsv` 文件。
3. 选择**转换**。
4. 查看结果下方说明中的行数和列数。
5. 复制表格或保存 `table.typ`，然后将它粘贴到文档中。

像这样的工作表：

| 模型 | 准确率 | 时间 (s) |
| --- | ---: | ---: |
| 基线 | 0.81 | 12.4 |
| 所提方法 | 0.87 | 10.9 |

会变成三列的 Typst 表格。数字列右对齐，文本列左对齐，横线标出顶部、表头下方和底部。Typst 不需要为此添加额外的包。

## 电子表格的行为

- Oleafly 读取工作簿中的**第一个工作表**。
- 公式单元格使用文件中缓存的结果。如果数值可能已过时，请先重新计算并保存电子表格。
- 合并区域的值取自左上角的单元格。其他单元格为空。
- Typst 会当作标记读取的字符会被转义。
- 转换留在你的设备上进行。

:::caution[大小和布局的限制]
工作表最多可以有 10,000 行和 100 列，单元格文本不超过 2 MB。图表、颜色、单元格样式、公式以及工作表之间的链接都不会被复现。
:::

要改为把数据文件带入已打开的 Typst 文档，请在编辑器中右键点击，选择**从 CSV/XLSX 导入表格…**。该对话框还能读取 JSON，可添加图注和标签，并且可以让表格与项目中的一份数据副本保持链接，这样编辑数据后，表格会在下次编译时更新。
