Mermaid — современный стандарт для визуализации в Markdown
Mermaid — язык диаграмм, интегрированный в GitHub, Notion, Obsidian, GitLab и ChatGPT.
Позволяет быстро создавать схемы прямо в Markdown, без установки ПО.
Mermaid — это JavaScript-библиотека и язык описания диаграмм, ориентированный на простоту.
Она поддерживает:
-
блок-схемы (flowchart);
-
диаграммы последовательностей (sequence);
-
диаграммы классов, Gantt-диаграммы, ERD, state-диаграммы;
-
C4-модели, mindmap и даже небольшие BPMN-подобные структуры.
Пример:
graph LR A[Клиент] --> B[Веб-приложение] B --> C[Сервис API] C --> D[База данных]
Преимущества Mermaid:
-
встроена в большинство современных wiki и систем документации;
-
визуализируется “на лету” без сторонних приложений;
-
идеально подходит для живой документации архитектуры и CI/CD.
Она менее формальна, чем PlantUML, но быстрее в работе и понятнее для не-технических специалистов.