# Из Markdown в LaTeX

Превращайте заметки или черновик в Markdown в самодостаточный документ LaTeX, не выстраивая базовую структуру вручную.

Инструмент «Из Markdown в LaTeX» позволяет идее зародиться в простой форме и вырасти в свёрстанный документ. Заголовки, текст, выделение, списки, ссылки, код и распространённые формулы становятся самодостаточным файлом `.tex`, который можно скомпилировать и доработать.

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

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

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

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

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

Этот Markdown:

```markdown
## Result

The loss fell by **12%**.

$$L(\theta) = \sum_i (y_i - \hat y_i)^2$$
```

превращается в раздел, полужирный текст и выключную формулу в LaTeX.

## Завершение документа в LaTeX

Локальный маршрут через Pandoc даёт общую оболочку документа. Он не выбирает журнальный класс, не выдумывает библиографические метаданные и не знает, какие пакеты потребуются вашему итоговому шаблону.

После преобразования выберите подходящий класс или шаблон, проверьте пути к изображениям и блоки кода, проверьте формулы и подключите файл `.bib`, если в Markdown использовались цитаты. «Сырой» HTML и расширения, специфичные для одного диалекта Markdown, могут потребовать ручной чистки.

Если цель — Typst, инструмент [Из Markdown в Typst](/docs/tools/markdown-to-typst/) избавляет от лишнего преобразования. Об импорте на уровне проекта и других целевых форматах читайте в разделе [Импорт проекта](/docs/import-project/).