# Из Excel в LaTeX

Превратите первый лист файла Excel, CSV или TSV в экранированную таблицу LaTeX.

Из Excel в LaTeX берёт уже существующую таблицу и убирает самую медленную часть переноса её в статью: экранирование каждой ячейки и ручное написание структуры строк.

## Для чего подходит

Используйте инструмент для аккуратной прямоугольной таблицы данных, сводной статистики, сравнительной сетки или результатов, подготовленных в электронной таблице. Результат использует первую строку как полужирный заголовок и создаёт исходник таблицы LaTeX, который можно редактировать.

Используйте [Из таблицы в LaTeX](/docs/tools/table-to-latex/), когда вы создаёте небольшую таблицу с нуля или хотите настроить ячейки визуально перед копированием кода. Для документа Typst используйте [Из Excel в Typst](/docs/tools/excel-to-typst/). Графики и диаграммы оставляйте рисунками, а не превращайте их в таблицы.

## Преобразование листа

1. Откройте **Из Excel в LaTeX** или выполните команду `/excel-to-latex`.
2. Выберите файл `.xlsx`, `.xls`, `.csv` или `.tsv`.
3. Нажмите **Преобразовать**.
4. Проверьте определённое количество строк и столбцов.
5. Скопируйте или сохраните `table.tex`, затем вставьте его в свой документ.

Лист вроде этого:

| Модель | Точность | Время (с) |
| --- | ---: | ---: |
| Базовая | 0.81 | 12.4 |
| Предлагаемая | 0.87 | 10.9 |

превращается в экранированный LaTeX со строкой заголовка. Добавьте сгенерированное требование пакета в преамбулу, если ваш документ ещё не подключает его.

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

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

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

После вставки таблицы скомпилируйте документ и проверьте ширину, выравнивание, значащие цифры, единицы и подпись. Таблица, верная в Excel, всё равно может оказаться слишком широкой для полосы журнала.

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