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

превращается в таблицу Typst с тремя столбцами. Числовые столбцы выравниваются по правому краю, текстовые — по левому, а горизонтальные линии отмечают верх, заголовок и низ. Typst не требует для этого дополнительного пакета.

## Поведение электронной таблицы

- Oleafly читает **первый лист** в книге.
- Ячейки с формулами используют результат, кэшированный в файле. Сначала пересчитайте и сохраните электронную таблицу, если значения могли устареть.
- Объединённый диапазон даёт значение из левой верхней ячейки. Остальные ячейки пусты.
- Символы, которые Typst воспринял бы как разметку, экранируются.
- Преобразование выполняется на вашем устройстве.

:::caution[Пределы размера и макета]
Лист может содержать до 10 000 строк и 100 столбцов, а объём текста ячеек — не более 2 МБ. Диаграммы, цвета, оформление ячеек, формулы и связи между листами не воспроизводятся.
:::

Чтобы вместо этого перенести файл данных в открытый документ Typst, щёлкните правой кнопкой мыши в редакторе и выберите **Таблица из CSV или XLSX…**. Этот диалог также читает JSON, принимает подпись и метку и может хранить таблицу связанной с копией данных в проекте, так что редактирование данных обновит таблицу при следующей компиляции.
