# 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 потрібні пакунки, названі в згенерованому коді.