# Excel 转 LaTeX

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

Excel 转 LaTeX 接手一份已经存在的表格，省去把它搬进论文时最耗时的部分：给每个单元格转义，并手写行结构。

## 最适合的场景

适合干净的矩形数据表、汇总统计、对比表，或在电子表格中准备好的结果。输出把第一行当作粗体表头，并生成可以编辑的 LaTeX 表格源码。

当你要从零开始构建一个小表格，或想在复制代码之前以可视化方式调整单元格时，请使用[表格转 LaTeX](/docs/tools/table-to-latex/)。对于 Typst 文档，请使用 [Excel 转 Typst](/docs/tools/excel-to-typst/)。曲线图和图表请保留为图片，不要把它们变成表格。

## 转换工作表

1. 打开 **Excel 转 LaTeX**，或运行 `/excel-to-latex`。
2. 选择一个 `.xlsx`、`.xls`、`.csv` 或 `.tsv` 文件。
3. 选择**转换**。
4. 查看检测到的行数和列数。
5. 复制或保存 `table.tex`，然后将它粘贴到文档中。

像这样的工作表：

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

会变成带表头行的已转义 LaTeX。如果文档的导言区还没有包含生成时要求的宏包，请把它加进去。

## 电子表格的行为

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

:::caution[大小和布局的限制]
导入的区域最多可以有 10,000 行和 100 列，单元格文本不超过 2 MB。更大的工作簿请拆分，或把你需要的那个区域导出为 CSV。多个工作表之间的关联、图表、颜色、公式和单元格样式都不会被复现。
:::

粘贴表格后，请编译并检查宽度、对齐、有效数字、单位和图注。在 Excel 中正确的表格，放进期刊的页面版式后仍可能过宽。

打开 LaTeX 文档时，你也可以直接从文件插入表格：在编辑器中右键点击，选择**从 CSV/XLSX 导入表格…**。该对话框可以读取 CSV、TSV、XLSX 和 JSON 文件，并可添加可选的图注和标签。