Mermaid у LaTeX

Mermaid у LaTeX дає змогу діаграмі початися з кількох читабельних рядків, а закінчитися в статті. Поширені блок-схеми стають придатним до редагування TikZ, тож підписи, стилі ліній і розташування можуть лишатися частиною початкового коду LaTeX.

Найкраще застосування

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

Для публікаційного рисунка з графіками, предметною нотацією чи точним ручним компонуванням скористайтеся натомість засобами для діаграм і рисунків. Не очікуйте, що кожне сімейство діаграм Mermaid має вірний відповідник у TikZ. Для документа Typst Mermaid у Typst пише код fletcher.

Перетворення блок-схеми

1. Відкрийте Mermaid у LaTeX або виконайте /mermaid-to-latex.
2. Вставте початковий код Mermaid або завантажте приклад.
3. Виберіть Перетворити.
4. Прочитайте примітку над результатом, щоб побачити, чи ви отримали TikZ, чи рисунок LaTeX на основі зображення.
5. Скопіюйте або збережіть початковий код .tex і будь-який згенерований ресурс.

Приклад:

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