mermaid

• https://mermaid.js.org/intro/syntax-reference.html — собстно, синтаксис диаграмм, главное
• https://github.com/arnm/ob-mermaid и https://github.com/mermaid-js/mermaid-cli - чтоб работало в org-babel. Именно mermaid-cli надо, чтоб генерить диаграммы. Из org-mode можно сразу из src-блока диаграммы делать. В markdown менее удобно. Но всякие zed умеют предпросмотр.
• https://github.com/abrochard/mermaid-mode – теоретически и мод отдельно для mermaid есть.
• https://github.com/mermaid-js/mermaid-live-editor - гитхаб редактора для нее, но невнятный
• https://habr.com/ru/articles/652867/ - типа куча примеров для тех, кто не помнит и влом.
• 2026-07-20 - Обнаружила, что в репах дебиана завелся node-mermaid, https://github.com/knsv/mermaid. Но это не mermaid-cli :)

• 2025-04-29 - почему-то у меня сейчас не работает. Пример про стили:

  class node1,node2,node3 BROWN
  classDef BROWN fill:#828282,stroke:none,color:#fff
  

• mmdc -i readme.template.md -o readme.md — находит в markdown-файле диаграммы, превращает в картинки, создает выходной файл со ссылками на картинки, но без кода диаграмм. И, насколько я понимаю, даже не прячет код диаграмм в созданные картинки. Но всё равно полезное для генерирования документа на отдачу.

Кириллицу в надписях умеет.

graph TD;
    A-->B;
    A-->Так;

    B-->D;
    Так-->D;

Такой способ задавать настройки должен бы работать, но не хочет.

(setq ob-mermaid-cli-path "~/node_modules/.bin/mmdc")

(а сейчас путь другой — ~/.npm-global/bin/mmdc. Просто занятно. which — удобная команда для выяснения :))

А вот добавление в PATH помогает.

sequenceDiagram
    Alice->>John: Hello John, how are you?
    John-->>Alice: Great!
    Alice-)John: See you later!

Без file отказывается запускаться.

• file - Output file. It should be either svg, png or pdf.
• width - Width of the page. Optional.
• height - Height of the page. Optional.
• theme - Theme of the chart, could be default, forest, dark or neutral. Optional.
• background-color - Background color. Example: transparent, red, ‘#F0F0F0’. Optional. У меня срабатывает указание цвета по имени (например, yellow), и не срабатывает в hex (например, #FFFF00), просто игнорируется.
• mermaid-config-file - JSON configuration file for mermaid. Optional.
• css-file - CSS file for the page. Optional.
• pupeteer-config-file - JSON configuration file for puppeteer. Optional.
• pdf-fit - Scale PDF to fit chart. Optional.