# CSV 轉 Typst

貼上 CSV 或 TSV 列，取得已跳脫的 Typst 表格，附有標題列和水平線。

CSV 轉 Typst 會把複製的試算表列轉成 Typst 表格。貼上資料列、轉換，然後把表格貼進你的 `.typ` 檔案。

## 適用時機

- 你從試算表或結果檔案複製了一個範圍；
- 資料已經是純文字，例如小型的 CSV 匯出檔；
- 你想要已跳脫的 Typst 原始碼，而不必自己寫 `table` 呼叫。

若是 `.xlsx` 或 `.xls` 活頁簿，請使用 [Excel 轉 Typst](/docs/tools/excel-to-typst/)。若是 LaTeX 文件，請使用 [Excel 轉 LaTeX](/docs/tools/excel-to-latex/)。

## 轉換資料列

1. 開啟 **CSV 轉 Typst**，或執行 `/csv-to-typst`。
2. 貼上以逗號或 Tab 分隔的資料列，或選擇**載入範例**。
3. 選擇**轉換**。
4. 查看結果下方說明中的列數與欄數。
5. 複製表格，或儲存 `table.typ`。

例如：

```text
Method,Accuracy,Runtime (s)
Baseline,0.82,14.2
Oleafly,0.95,9.8
```

會變成一個三欄的 `#table`。第一列是標題列，以粗體顯示。數字欄靠右對齊，文字欄靠左對齊。水平線位於標題列上方、下方，以及最後一列的下方，沒有垂直線。

## 表格行為

- Oleafly 會從第一行偵測是 Tab 還是逗號。
- 以引號括起的儲存格可以包含逗號、引號和換行。儲存格內的換行會變成空格。
- Typst 會當成標記讀取的字元，例如 `#`、`*`、`_` 和 `$`，都會被跳脫。
- 轉換在你的裝置上執行。

:::caution[大小限制]
表格最多可以有 10,000 列和 100 欄，儲存格文字不得超過 2 MB。
:::

在 Typst 文件內，你可以略過複製貼上。在編輯器中按右鍵並選擇**從 CSV/XLSX 匯入表格…**。該對話框可讀取 CSV、TSV、XLSX 或 JSON 檔案，可加入選用的圖說和標籤，並可讓表格與它的資料檔案保持連結，使表格在下次編譯時更新。請參閱[用 Typst 寫作](/docs/writing/typst/)。
