# CSV sang Typst

Dán các dòng CSV hoặc TSV và nhận một bảng Typst đã thoát ký tự, có hàng tiêu đề và các đường kẻ ngang.

CSV to Typst biến những dòng bảng tính đã sao chép thành một bảng Typst. Dán các dòng đó, chuyển đổi, rồi dán bảng vào tệp `.typ` của bạn.

## Khi nào dùng

- bạn đã sao chép một vùng từ bảng tính hoặc từ tệp kết quả;
- dữ liệu đã là văn bản thuần, chẳng hạn một bản xuất CSV nhỏ;
- bạn muốn mã nguồn Typst đã thoát ký tự mà không phải tự viết lệnh `table`.

Với sổ làm việc `.xlsx` hoặc `.xls`, hãy dùng [Excel to Typst](/docs/tools/excel-to-typst/). Với tài liệu LaTeX, hãy dùng [Excel to LaTeX](/docs/tools/excel-to-latex/).

## Chuyển đổi các dòng

1. Mở **CSV to Typst**, hoặc chạy `/csv-to-typst`.
2. Dán các dòng phân cách bằng dấu phẩy hoặc tab, hoặc chọn **Load example**.
3. Chọn **Convert**.
4. Kiểm tra số hàng và số cột trong ghi chú bên dưới kết quả.
5. Sao chép bảng hoặc lưu `table.typ`.

Ví dụ:

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

sẽ thành một `#table` với ba cột. Dòng đầu là hàng tiêu đề, được in đậm. Các cột số được căn phải và các cột văn bản căn trái. Các đường kẻ ngang nằm phía trên hàng tiêu đề, ngay dưới nó, và dưới dòng cuối cùng, không có đường dọc nào.

## Hành vi của bảng

- Oleafly nhận diện tab hay dấu phẩy từ dòng đầu tiên.
- Ô được đặt trong ngoặc kép có thể chứa dấu phẩy, ngoặc kép và xuống dòng. Một lần xuống dòng bên trong ô sẽ thành một dấu cách.
- Các ký tự mà Typst sẽ đọc như markup, chẳng hạn `#`, `*`, `_` và `$`, được thoát.
- Quá trình chuyển đổi chạy trên thiết bị của bạn.

:::caution[Giới hạn kích thước]
Một bảng có thể có tối đa 10.000 hàng và 100 cột, với không quá 2 MB văn bản ô.
:::

Trong một tài liệu Typst, bạn có thể bỏ qua bước sao chép và dán. Nhấp chuột phải trong trình soạn thảo và chọn **Table from CSV/XLSX…**. Hộp thoại đó đọc các tệp CSV, TSV, XLSX hoặc JSON, thêm chú thích và nhãn tùy chọn, và có thể giữ bảng được liên kết với tệp dữ liệu của nó để bảng cập nhật ở lần biên dịch tiếp theo. Xem [Viết bằng Typst](/docs/writing/typst/).
