# Из CSV в Typst

Вставьте строки CSV или TSV и получите экранированную таблицу Typst со строкой заголовка и горизонтальными линиями.

Из CSV в Typst превращает скопированные строки электронной таблицы в таблицу Typst. Вставьте строки, преобразуйте их и вставьте таблицу в свой файл `.typ`.

## Когда использовать

- скопировали диапазон из электронной таблицы или файла с результатами;
- данные уже представлены простым текстом, например небольшим экспортом в CSV;
- нужен экранированный исходник Typst без самостоятельного написания вызова `table`.

Для книги `.xlsx` или `.xls` используйте [Из Excel в Typst](/docs/tools/excel-to-typst/). Для документа LaTeX — [Из Excel в LaTeX](/docs/tools/excel-to-latex/).

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

1. Откройте **Из CSV в Typst** или выполните команду `/csv-to-typst`.
2. Вставьте строки, разделённые запятыми или табуляцией, или нажмите **Загрузить пример**.
3. Нажмите **Преобразовать**.
4. Проверьте количество строк и столбцов в примечании под результатом.
5. Скопируйте таблицу или сохраните `table.typ`.

Например:

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

превращается в `#table` с тремя столбцами. Первая строка — заголовок, набранный полужирным. Числовые столбцы выравниваются по правому краю, текстовые — по левому. Горизонтальные линии проходят над заголовком, под ним и под последней строкой, вертикальных линий нет.

## Поведение таблицы

- Oleafly определяет табуляции или запятые по первой строке.
- Заключённые в кавычки ячейки могут содержать запятые, кавычки и переводы строк. Перевод строки внутри ячейки превращается в пробел.
- Символы, которые Typst воспринял бы как разметку, например `#`, `*`, `_` и `$`, экранируются.
- Преобразование выполняется на вашем устройстве.

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

В документе Typst можно обойтись без копирования и вставки. Щёлкните в редакторе правой кнопкой мыши и выберите **Таблица из CSV или XLSX…**. Этот диалог читает файлы CSV, TSV, XLSX или JSON, добавляет необязательные подпись и метку и может связать таблицу с её файлом данных, чтобы таблица обновлялась при следующей компиляции. См. [Писать в Typst](/docs/writing/typst/).
