# Из LaTeX в Typst

Превратите черновик LaTeX в исходник Typst, который можно изучить, сохранить или открыть как новый проект.

Инструмент «Из LaTeX в Typst» поможет быстро начать, когда вам нужен быстрый локальный рабочий процесс Typst, но ваш материал уже написан на LaTeX. Он переносит типовую структуру документа и математику, а затем оставляет результат открытым для решений, которые может принять только автор.

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

- статьи или заметки из стандартных разделов, текста, списков, ссылок, таблиц и формул;
- проверка того, подходит ли существующий черновик для Typst;
- перенос содержимого без перепечатывания.

Оставайтесь на LaTeX, когда работа зависит от класса издательства, большого слоя макросов или пакетов без аналога в Typst. Преобразование не может заставить журнал принять другой формат исходника.

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

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

Стандартная `\section`, абзац, маркированный список и выключная формула перейдут в свои эквиваленты Typst. Пользовательскую команду вроде `\newcommand{\model}{...}` может понадобиться вручную превратить в функцию или переменную Typst.

## Проверка миграции

Встроенное преобразование Pandoc выполняется локально и применяет к сгенерированному Typst совместимую чистку. Оно не воспроизводит поведение пакетов LaTeX и визуальные правила класса документа.

Проверьте:

- пользовательские макросы и окружения;
- синтаксис и нумерацию формул;
- пути к рисункам и подписи;
- таблицы и перекрёстные ссылки;
- оформление библиографии и цитат;
- геометрию страницы и типографику.

Храните исходный проект, пока версия Typst не скомпилируется и полный PDF не будет сравнён. Для обратного маршрута используйте [Из Typst в LaTeX](/docs/tools/typst-to-latex/).

## Преобразование целого проекта

Этот инструмент преобразует текст, который вы вставляете. Для проекта LaTeX с несколькими файлами, рисунками и библиографией откройте проект и запустите **Преобразовать в проект Typst** из палитры команд. Он создаёт отдельный проект Typst, компилирует его и сообщает, чему нужно внимание. В разделе [Проекты Typst](/docs/typst/#convert-a-latex-project-to-typst) это разобрано по шагам. Для одиночной формулы быстрее воспользоваться инструментом [Из формулы в Typst](/docs/tools/equation-to-typst/).