# 表格、公式與參考文獻檢查

從編輯器把試算表匯入為 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」**，建立三欄，並輸入標題列，接著是你的數值：

| 方法 | 準確度 | 時間（秒） |
| --- | ---: | ---: |
| 基準 | 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)。