# Из Mermaid в LaTeX

Превращайте блок-схему Mermaid в редактируемый TikZ, когда это возможно, с локальной заменой изображением для других типов диаграмм.

Инструмент «Из Mermaid в LaTeX» позволяет диаграмме начаться с нескольких читаемых строк и закончиться в статье. Стандартные блок-схемы превращаются в редактируемый TikZ, поэтому подписи, стили линий и размещение остаются частью исходника LaTeX.

## Лучшее применение

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

Для публикуемого рисунка с графиками, предметной нотацией или точной ручной композицией используйте вместо этого [инструменты для диаграмм и рисунков](/docs/figures-diagrams/). Не ожидайте, что у каждого семейства диаграмм Mermaid есть точный эквивалент в TikZ. Для документа Typst инструмент [Из Mermaid в Typst](/docs/tools/mermaid-to-typst/) вместо этого пишет код fletcher.

## Преобразование блок-схемы

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

Пример:

```mermaid
flowchart LR
  question[Research question] --> search[Search literature]
  search --> decide{Enough evidence?}
  decide -->|Yes| write[Write synthesis]
  decide -->|No| search
```

Стандартные блок-схемы с направлением `TD`, `TB`, `BT`, `LR` или `RL` и базовыми узлами и рёбрами детерминированно преобразуются в TikZ. Если синтаксис использует возможность Mermaid без безопасного соответствия в TikZ, Oleafly локально отрисовывает диаграмму в PNG и возвращает фрагмент рисунка LaTeX вместо того, чтобы терять связи.

## Проверка рисунка

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

Преобразование выполняется на вашем устройстве. Ввод Mermaid ограничен 50 000 символов. Запасной вариант с изображением требует `graphicx`; редактируемому TikZ нужны пакеты, названные в сгенерированном исходнике.