# 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 |

3 列の Typst の表になります。数値の列は右揃え、テキストの列は左揃えで、水平線が上、ヘッダー、下に引かれます。そのために追加のパッケージは必要ありません。

## スプレッドシートの扱い

- Oleafly は、ブックの**最初のシート**を読み込みます。
- 数式のセルには、ファイルにキャッシュされた結果が使われます。値が古い可能性があるときは、先にスプレッドシートを再計算して保存してください。
- 結合された範囲は、左上のセルの値だけが使われます。ほかのセルは空になります。
- Typst がマークアップとして読む文字は、エスケープされます。
- 変換は、お使いのデバイス上にとどまります。

:::caution[サイズとレイアウトの制限]
シートは、最大で 10,000 行、100 列まで、セルのテキストは合わせて 2 MB までです。グラフ、色、セルの書式、数式、シート間のリンクは再現されません。
:::

データファイルを開いている Typst の文書に取り込むには、代わりにエディタで右クリックして、**CSV / XLSX から表を作成…** を選びます。このダイアログは JSON も読み込み、キャプションとラベルを指定でき、表をプロジェクト内のデータのコピーにリンクしたままにして、データを編集すると次回のコンパイルで表が更新されるようにもできます。
