# CSV から Typst へ

CSV または TSV の行を貼り付けて、ヘッダー行と水平線付きの、エスケープ済みの Typst の表を得ます。

CSV から Typst へは、コピーしたスプレッドシートの行を Typst の表にします。行を貼り付けて変換し、その表を `.typ` ファイルに貼り付けます。

## こんなときに使う

- スプレッドシートや結果ファイルから範囲をコピーしたとき
- 小さな CSV の書き出しなど、データがすでにプレーンテキストのとき
- `table` の呼び出しを自分で書かずに、エスケープ済みの Typst のソースが欲しいとき

`.xlsx` や `.xls` のブックには、[Excel から Typst へ](/docs/tools/excel-to-typst/)を使います。LaTeX の文書には、[Excel から LaTeX へ](/docs/tools/excel-to-latex/)を使います。

## 行を変換する

1. **CSV から Typst へ**を開くか、`/csv-to-typst` を実行します。
2. カンマ区切りまたはタブ区切りの行を貼り付けるか、**例を読み込む**を選びます。
3. **変換**を選びます。
4. 結果の下のメモで、行数と列数を確認します。
5. 表をコピーするか、`table.typ` を保存します。

例:

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

は、3 列の `#table` になります。最初の行がヘッダーで、太字になります。数値の列は右揃え、テキストの列は左揃えです。水平線は、ヘッダーの上と下、最後の行の下に引かれ、縦線はありません。

## 表の動作

- Oleafly は、最初の行からタブかカンマかを判別します。
- 引用符で囲んだセルには、カンマ、引用符、改行を含められます。セル内の改行は、スペースになります。
- `#`、`*`、`_`、`$` など、Typst がマークアップとして読む文字は、エスケープされます。
- 変換は、お使いのデバイス上で行われます。

:::caution[サイズの制限]
表は、最大で 10,000 行、100 列まで、セルのテキストは合わせて 2 MB までです。
:::

Typst の文書の中なら、コピーと貼り付けを省けます。エディタで右クリックして、**CSV / XLSX から表を作成…** を選びます。このダイアログは、CSV、TSV、XLSX、JSON のファイルを読み込み、任意のキャプションとラベルを加えられ、表をデータファイルにリンクしたままにして、次回のコンパイルで表を更新することもできます。[Typst で書く](/docs/writing/typst/)を参照してください。
