# Из 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 символов. Скомпилируйте результат при финальной ширине и проверьте переносы подписей, пересечения и направление стрелок.
