# Из Markdown в Typst

Преобразуйте заметки в Markdown в исходник Typst и откройте их в быстром локальном проекте для письма.

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

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

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

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

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

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

Например, заголовки Markdown, полужирный текст, нумерованный список и формулы в долларах превращаются в свои аналоги в Typst. Преобразование выполняется локально с помощью встроенного Pandoc.

## Что поправить потом

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

Скомпилируйте новый проект и проверьте:

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

Для подачи в LaTeX используйте напрямую [Из Markdown в LaTeX](/docs/tools/markdown-to-latex/). Для обратного пути используйте [Из Typst в Markdown](/docs/tools/typst-to-markdown/). Для пустого рабочего пространства Typst начните с [Визуального редактора Typst](/docs/tools/visual-typst-editor/) или [Редактора Typst](/docs/tools/typst-editor/).