# Excel sang Typst

Biến trang tính đầu tiên của một tệp Excel, CSV, hoặc TSV thành một bảng Typst đã thoát ký tự.

Excel to Typst chuyển một bảng đã hoàn thiện từ bảng tính vào một tài liệu Typst. Nó đọc tệp, thoát ký tự cho từng ô, và viết lệnh `#table` giúp bạn.

## Phù hợp nhất

Hãy dùng nó cho một bảng hình chữ nhật gọn gàng: các kết quả, thống kê tóm tắt, hoặc một lưới so sánh được chuẩn bị trong bảng tính. Hàng đầu tiên trở thành hàng tiêu đề in đậm.

Nếu các hàng đã nằm trong bộ nhớ tạm, [CSV to Typst](/docs/tools/csv-to-typst/) nhận văn bản được dán. Với tài liệu LaTeX, hãy dùng [Excel to LaTeX](/docs/tools/excel-to-latex/). Hãy giữ biểu đồ và đồ thị dưới dạng hình vẽ.

## Chuyển đổi một trang tính

1. Mở **Excel to Typst**, hoặc chạy `/excel-to-typst`.
2. Chọn một tệp `.xlsx`, `.xls`, `.csv`, hoặc `.tsv`.
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`, rồi dán nó vào tài liệu của bạn.

Một trang tính như thế này:

| Mô hình | Độ chính xác | Thời gian (s) |
| --- | ---: | ---: |
| Baseline | 0.81 | 12.4 |
| Proposed | 0.87 | 10.9 |

sẽ thành một bảng Typst ba cột. Các cột số được căn phải, các cột văn bản được căn trái, và các đường kẻ ngang đánh dấu mép trên, hàng tiêu đề, và mép dưới. Typst không cần thêm gói lệnh nào cho việc này.

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

- Oleafly đọc **trang tính đầu tiên** trong một sổ làm việc.
- Các ô công thức dùng kết quả được lưu đệm trong tệp. Hãy tính toán lại và lưu bảng tính trước nếu các giá trị có thể đã cũ.
- Một vùng hợp nhất đóng góp giá trị của nó từ ô trên cùng bên trái. Các ô khác để trống.
- Các ký tự mà Typst sẽ đọc như markup được thoát.
- Quá trình chuyển đổi vẫn nằm trên thiết bị của bạn.

:::caution[Giới hạn kích thước và bố cục]
Trang tính có thể chứa tối đa 10.000 hàng và 100 cột, với không quá 2 MB văn bản ô. Biểu đồ, màu sắc, kiểu dáng ô, công thức, và các liên kết giữa các trang tính không được tái tạo.
:::

Để đưa một tệp dữ liệu thẳng vào một tài liệu Typst đang mở, hãy 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ũng đọc JSON, nhận một chú thích và một nhãn, và có thể giữ bảng được liên kết với một bản sao dữ liệu trong dự án, nhờ đó việc chỉnh sửa dữ liệu sẽ cập nhật bảng ở lần biên dịch tiếp theo.
