NEQL↗TRAINING / 01 ↗

NEQL / ЖУРНАЛ

Технологии / 3 минуты / 14 ноября 2026

Диаграмма ролей в Markdown через VS Code

Скопируйте пример для Mermaid 12 и проверьте, кто что может делать в каталоге.

11 ноября 2026 года Microsoft выпустила VS Code 1.146. Встроенный предпросмотр Markdown в этой версии использует Mermaid 12 и умеет показывать диаграммы вариантов использования. Такая диаграмма помогает описать, какие действия система предоставляет каждой роли. В примере ниже читатель ищет и бронирует книгу, а библиотекарь подтверждает бронь.

В этой статье
Открыть справку по предпросмотру MarkdownСверить синтаксис Mermaid

Откройте предпросмотр файла

Скопируйте блок целиком, включая первую и последнюю строки, в файл с расширением .md. В палитре команд VS Code выберите Markdown: Open Preview to the Side. Тогда правки можно вносить слева и сразу видеть их на схеме справа.

```mermaid
usecase-beta
direction LR
actor Reader("Читатель")
actor Librarian("Библиотекарь")
systemBoundary "Каталог"
  Find("Найти книгу")
  Reserve("Забронировать")
  Confirm("Подтвердить бронь")
end
Reader --> Find
Reader --> Reserve
Librarian --> Confirm
```

Прочитайте связи между ролями и действиями

Внутри рамки «Каталог» находятся действия, а снаружи — роли. Идентификатор Reader связан с поиском книги и бронированием. Librarian связан с подтверждением. Если нужно показать очередь действий, нарисуйте отдельную блок-схему с шагами и условиями. Здесь стрелки показывают, какой роли доступно действие.

Проверьте версию там, где будут читать файл

Если схема не появилась, сначала проверьте версию VS Code и убедитесь, что в первой строке блока указано mermaid, а внутри блока стоит usecase-beta. В документации Mermaid этот синтаксис помечен как бета. Если тот же файл будут открывать в другом редакторе или на сайте, проверьте его предпросмотр отдельно и оставьте рядом короткое описание ролей.

Оригинал статьи: https://neql.org/blog/vscode-mermaid-usecase-preview