# 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`，然後貼進你的文件。

像這樣的工作表：

| 模型 | 準確率 | 時間（秒） |
| --- | ---: | ---: |
| 基準線 | 0.81 | 12.4 |
| 本方法 | 0.87 | 10.9 |

會變成三欄的 Typst 表格。數字欄靠右對齊，文字欄靠左對齊，水平線標示出頂端、標題列和底端。Typst 不需要為它加裝額外的套件。

## 試算表行為

- Oleafly 讀取活頁簿中的**第一個工作表**。
- 公式儲存格使用檔案中快取的結果。如果數值可能已過期，請先重新計算並儲存試算表。
- 合併的範圍只取左上角儲存格的值，其他儲存格為空白。
- Typst 會當成標記讀取的字元會被跳脫。
- 轉換留在你的裝置上。

:::caution[大小與版面限制]
工作表最多可包含 10,000 列和 100 欄，儲存格文字不得超過 2 MB。圖表、顏色、儲存格樣式、公式，以及工作表之間的連結都不會被重現。
:::

若要改為把資料檔案帶進開啟中的 Typst 文件，請在編輯器中按右鍵並選擇**從 CSV/XLSX 匯入表格…**。該對話框也可讀取 JSON、接受圖說與標籤，並可讓表格與專案中的資料副本保持連結，因此編輯資料會在下次編譯時更新表格。
