Как открыть файл .mmd

Что вы видите

No diagram type detected matching given configuration for text: ```mermaid

Почему

Вы скопировали диаграмму из файла Markdown или из переписки вместе с ограждением. Три обратные кавычки — это Markdown, а не Mermaid, поэтому разборщик до диаграммы не добирается.

Решение

Удалите открывающую строку ```mermaid и закрывающую ```. Файл должен начинаться с ключевого слова диаграммы.

```mermaid
flowchart TD
    A[Начало] --> B[Конец]
```

flowchart TD
    A[Начало] --> B[Конец]

Что вы видите

Parse error, сообщение заканчивается на: got 'PS'

Ошибка заканчивается на: got 'PS'

Почему

Открывающая круглая скобка внутри подписи узла. В Mermaid круглые скобки — синтаксис формы: A(текст) означает узел со скруглёнными углами, поэтому голая скобка внутри квадратных читается как начало формы.

Решение

Возьмите подпись в двойные кавычки. Внутри кавычек всё считается текстом, включая скобки.

flowchart TD
    A[Вызвать списание(заказ)] --> B[Конец]

flowchart TD
    A["Вызвать списание(заказ)"] --> B[Конец]

Что вы видите

Parse error в строке, где вы назвали узел

Почему

В идентификаторе узла есть пробел. По-русски этого легко не заметить, потому что естественные названия — словосочетания: «сервис авторизации», «база пользователей». Идентификатор — токен перед стрелкой, пробел его обрывает, и остаётся лишнее слово, которое некуда деть.

Решение

Дайте узлу идентификатор из одного слова, а читаемый текст поместите в подпись. Кириллица в идентификаторе работает; мешает только пробел.

flowchart TD
    сервис авторизации --> база данных

flowchart TD
    auth[Сервис авторизации] --> db[База данных]

Что вы видите

Parse error, сообщение заканчивается на: got 'STR'

Ошибка заканчивается на: got 'STR'

Почему

Двойная кавычка внутри подписи узла. Разборщик считает её началом строки в кавычках, а затем натыкается на квадратную скобку подписи там, где ждал закрывающую кавычку.

Решение

Возьмите подпись целиком в двойные кавычки, а внутри используйте «ёлочки» или запишите кавычку как HTML-сущность #quot;.

flowchart TD
    A[Он сказал "привет"] --> B[Конец]

flowchart TD
    A["Он сказал «привет»"] --> B[Конец]

Что вы видите

Parse error, сообщение заканчивается на: got 'end'

Ошибка заканчивается на: got 'end'

Почему

Вы использовали end как идентификатор узла. В нижнем регистре end закрывает подграф, поэтому разборщик видит конец блока там, где ожидал узел. Случается часто: следуя англоязычным примерам, последний узел по привычке называют end, даже если вся схема на русском.

Решение

Напишите с заглавной буквы или дайте узлу другой идентификатор, а слово перенесите в подпись. `Конец` проблем не создаёт.

flowchart TD
    A[Начало] --> end

flowchart TD
    A[Начало] --> Конец[Завершено]

Что вы видите

Рисуется, но в диаграмме состояний одно состояние распалось на два

Почему

Пробел внутри идентификатора состояния. В отличие от блок-схемы, диаграмма состояний не возражает: она создаёт отдельный прямоугольник на каждое слово. Измерено — `[*] --> Ожидает оплаты` даёт два состояния, `Ожидает` и `оплаты`, и только первое висит на стрелке. По-русски почти ни одно состояние не умещается в одно слово, поэтому ошибка встречается постоянно, а сигнала о ней нет.

Решение

Объявите состояние через `state "Подпись" as id` и ссылайтесь на него только по идентификатору.

stateDiagram-v2
    [*] --> Ожидает оплаты
    Ожидает оплаты --> Закрыт

stateDiagram-v2
    state "Ожидает оплаты" as ожидание
    [*] --> ожидание
    ожидание --> Закрыт

Что вы видите

No diagram type detected matching given configuration for text: sequencediagram

Почему

Ключевое слово диаграммы написано с ошибкой или не в том регистре. Ключевые слова Mermaid чувствительны к регистру: sequenceDiagram работает, sequencediagram — нет. То же касается stateDiagram-v2 и erDiagram.

Решение

Исправьте регистр. Учтите, что graph по-прежнему принимается как устаревший синоним flowchart, так что этот старый синтаксис проблемой не является.

sequencediagram
    Клиент->>API: Привет

sequenceDiagram
    Клиент->>API: Привет

Что вы видите

Parse error в подписи ребра между вертикальными чертами

Почему

Скобки внутри подписи ребра. К подписи |...| применяются те же ограничения, что и к подписи узла: скобки там синтаксис, а не текст.

Решение

Возьмите подпись ребра в кавычки.

flowchart TD
    A -->|да (всегда)| B

flowchart TD
    A -->|"да (всегда)"| B

Что вы видите

Parse error в ER-диаграмме, сообщение заканчивается на: got 'NEWLINE'

Ошибка заканчивается на: got 'NEWLINE'

Почему

Связь без подписи. В отличие от ребра блок-схемы, связь в ER требует двоеточия и глагола: это не необязательно, и без них строка заканчивается слишком рано.

Решение

Добавьте двоеточие и подпись. Если в подписи есть пробел, возьмите её в кавычки.

erDiagram
    КЛИЕНТ ||--o{ ЗАКАЗ

erDiagram
    КЛИЕНТ ||--o{ ЗАКАЗ : оформляет

Что вы видите

Parse error, указывающая на последнюю строку диаграммы

Почему

Блок открыт и не закрыт: alt, opt, loop, par и subgraph требуют своего end. Mermaid сообщает о сбое там, где у него кончается ввод, поэтому номер строки указывает на конец файла, а не на незакрытый блок.

Решение

Посчитайте открытые блоки и написанные end. Если ошибка на последней строке, почти всегда дело в этом.

sequenceDiagram
    Клиент->>API: Запрос
    alt Всё хорошо
        API-->>Клиент: OK

sequenceDiagram
    Клиент->>API: Запрос
    alt Всё хорошо
        API-->>Клиент: OK
    end

Что вы видите

Lexical error on line 1. Unrecognized text.

Почему

Недопустимое направление после ключевого слова диаграммы. Блок-схемы принимают TB, TD, BT, LR и RL, и больше ничего; опечатка здесь падает на лексическом анализе, до чтения узлов.

Решение

Используйте одно из пяти допустимых направлений. TD и LR закрывают почти все случаи.

flowchart XY
    A --> B

flowchart TD
    A --> B

Что вы видите

Здесь рисуется, а в GitLab, Confluence или старом инструменте — нет

Почему

Разница версий. Этот просмотрщик работает на Mermaid 11.12.2; GitLab.com документирует версию 10, а корпоративные вики нередко отстают на годы. Синтаксис, появившийся после версии другого инструмента, разбирается здесь и падает там.

Решение

Спросите у другого движка, какая у него версия. Если написать в диаграмме одно слово info, Mermaid нарисует собственный номер версии — это быстрее, чем читать список изменений.

info