# Mermaid у Typst

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

Mermaid у Typst бере блок-схему, записану кількома рядками Mermaid, і записує її як діаграму fletcher. Fletcher — це пакунок Typst для малювання діаграм із вузлів і стрілок. Підписи, форми й стрілки лишаються в початковому коді, де їх можна редагувати.

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

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

Щоб намалювати діаграму вручну або підправити перетворену на полотні, скористайтеся [редактором діаграм](/docs/figures-diagrams/). Для документа LaTeX використовуйте [Mermaid у LaTeX](/docs/tools/mermaid-to-latex/).

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

1. Відкрийте **Mermaid у Typst** або виконайте `/mermaid-to-typst`.
2. Вставте початковий код Mermaid або виберіть **Завантажити приклад**.
3. Виберіть **Перетворити**.
4. Прочитайте примітку під результатом. У ній сказано, чи ви отримали редагований код fletcher, чи відтворене зображення.
5. Скопіюйте або збережіть `diagram.typ`. Коли результат містить зображення, **Зберегти ZIP** тримає зображення разом із початковим кодом.

Приклад:

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

`flowchart` або `graph` із напрямком `TD`, `TB`, `LR`, `BT` чи `RL`, із підписами, підписами ребер, пунктирними або товстими зв’язками та поширеними формами вузлів стає кодом fletcher. Результат починається з рядка `#import` для fletcher, за яким іде виклик `#diagram` з одним `node` на кожен блок і одним `edge` на кожну стрілку.

## Версії fletcher

Рядок імпорту називає версію fletcher, яка працює з вашим Typst. Коли відкрито проєкт Typst, Oleafly вибирає її за версією Typst цього проєкту: fletcher 0.5.8 для Typst 0.13 і новіших, 0.5.5 для Typst 0.12 та 0.5.1 для старіших випусків. Коли жодного проєкту Typst не відкрито, ви отримуєте 0.5.8.

Typst завантажує fletcher із Typst Universe під час першої компіляції документа, який його використовує. Після цього він працює офлайн.

## Коли Oleafly відтворює зображення натомість

Деякий синтаксис Mermaid не має безпечного відповідника у fletcher: це інші типи діаграм, як-от діаграми послідовності, підграфи, рядки `style` і `classDef`, а також ланцюжки зв’язків на кшталт `a --> b --> c`. Тоді Oleafly малює діаграму на вашому пристрої, зберігає її як `assets/diagram.png` і повертає короткий `#figure`, що показує це зображення. Зв’язки лишаються видимими, але зображення не можна редагувати як код.

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