# 表格、公式和参考文献检查

在编辑器中把电子表格导入为 LaTeX 或 Typst 表格，或选择专门的工具来处理表格、公式、图片导出或 BibTeX 检查。

电子表格可以通过编辑器的右键菜单，直接放进你正在写的 LaTeX 或 Typst 文档。如果你想先得到某个结果，而不必先建好稿件，可以使用下面的某个工具。

## 从数据文件导入表格

在 LaTeX 或 Typst 文档中，右键点击表格应当出现的位置，选择 **从 CSV/XLSX 导入表格…**。对话框 **将电子表格导入为表格** 的用法如下：

1. 点击 **选择 CSV、TSV、XLSX 或 JSON**，然后选取文件。Excel 文件（`.xlsx` 和 `.xls`）读取的是第一个工作表。JSON 文件必须是记录列表或行列表。
2. 检查预览。它显示前几行和前几列，插入时会使用整张表格。
3. 如果第一行是列名，请保持 **首行为表头** 开启。
4. 如果需要，添加 **题注** 和 **标签**。两者都是可选的。像 `tab:results` 这样的标签，可以让你在 LaTeX 中用 `\ref{tab:results}`、在 Typst 中用 `@tab:results` 引用该表格。
5. 选择 **在光标处插入**，或选择 **复制源码** 把表格放到剪贴板。

表格会用文档所用的语言写出。LaTeX 表格的顶线、中线和底线使用 booktabs，所以文档需要 `\usepackage{booktabs}`。Typst 表格使用同样的三条线，不需要任何包。两种情况下，单元格中的特殊字符都会被转义。

### 让 Typst 表格与数据保持链接

在 Typst 文档中，对话框还有 **保持与数据文件的链接**。开启后，Oleafly 会把数据复制到项目的 `data` 文件夹，表格每次在文档编译时都会读取该文件。编辑这个文件，表格就会在下次编译时更新，无需重新导入。Excel 工作表会以 CSV 文件的形式保存在那里。链接的表格会插入到光标处，所以它不提供 **复制源码**。

LaTeX 表格始终以文本形式复制进源码。要更新它，请重新导入该文件。

## 从你手头的东西开始

这些工具属于 **Oleafly 工具**。在 **设置 → 实验功能** 中启用 **LaTeX 工具**，然后从项目库打开 **Oleafly 工具**。

| 你手头有 | 你需要 | 打开 |
| --- | --- | --- |
| 几行几列的数据 | 可编辑的 LaTeX 表格 | [表格转 LaTeX](/docs/tools/table-to-latex/) |
| Excel、CSV 或 TSV 文件 | 根据第一个工作表生成 LaTeX 表格 | [Excel 转 LaTeX](/docs/tools/excel-to-latex/) |
| Excel、CSV 或 TSV 文件 | 根据第一个工作表生成 Typst 表格 | [Excel 转 Typst](/docs/tools/excel-to-typst/) |
| 键入的记号或公式图片 | 可编辑的 LaTeX 公式 | [公式转 LaTeX](/docs/tools/equation-to-latex/) |
| 可用的 LaTeX 公式 | SVG、PNG、MathML 或网页片段 | [LaTeX 转图片](/docs/tools/latex-to-image/) |
| `.bib` 文件 | 结构错误和缺失的字段 | [BibTeX 校验器](/docs/tools/bibtex-validator/) |

## 一个小表格示例

打开 **表格转 LaTeX**，创建三列，输入表头，然后输入你的数值：

| 方法 | 准确率 | 时间 (s) |
| --- | ---: | ---: |
| 基线 | 0.81 | 12.4 |
| 修订版 | 0.86 | 10.1 |

把第一行标为表头，让数值列右对齐，并启用 `booktabs` 表线。把生成的源码复制到稿件中，如有需要添加 `\usepackage{booktabs}`，然后编译。

当手工复制单元格容易出错时，请改用 **Excel 转 LaTeX**。它读取第一个工作表，并把输入限制在 10,000 行、100 列和 2 MB 的单元格文本。公式单元格使用工作簿缓存的结果，所以导入之前请先重新计算并保存工作表。

## 双向的公式转换

对于 `sqrt(x^2 + y^2) <= r` 这样的记号，或需要转写的截图，请使用 **公式转 LaTeX**。简单的键入记号在本地规范化。自然语言描述的数学内容和图片则需要兼容的本地 Ollama 模型。

表达式正确之后，使用 **LaTeX 转图片**。SVG 在图表或网页中保持清晰；PNG 适用于无法放置 SVG 的软件。如果目标位置支持，优先选择 MathML 或可编辑的公式，因为单靠图片无法向辅助技术呈现数学结构。

## 在最终编译之前校验

把参考文献粘贴到 **BibTeX 校验器**，可以发现解析错误、缺失的必填字段和重复的键。结果干净，只说明文本在结构上有效，并不能确认所引用的作品存在，也不能确认其作者、标题、年份和标识符正确。

如果要对整个项目统一引用键、安全地处理重复项并更新引用，请使用[参考文献与引用](/docs/citations/#clean-a-reference-library)。