NEQL / ЖУРНАЛ
Технологии / 3 минуты / 14 ноября 2026
Диаграмма ролей в Markdown через VS Code
Скопируйте пример для Mermaid 12 и проверьте, кто что может делать в каталоге.
11 ноября 2026 года Microsoft выпустила VS Code 1.146. Встроенный предпросмотр Markdown в этой версии использует Mermaid 12 и умеет показывать диаграммы вариантов использования. Такая диаграмма помогает описать, какие действия система предоставляет каждой роли. В примере ниже читатель ищет и бронирует книгу, а библиотекарь подтверждает бронь.
В этой статье
Откройте предпросмотр файла
Скопируйте блок целиком, включая первую и последнюю строки, в файл с расширением .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 этот синтаксис помечен как бета. Если тот же файл будут открывать в другом редакторе или на сайте, проверьте его предпросмотр отдельно и оставьте рядом короткое описание ролей.
- Microsoft — выпуск Visual Studio Code 1.146 от 11 ноября 2026 года
- Microsoft — встроенный предпросмотр Markdown в VS Code, проверено 14 ноября 2026 года
- Mermaid — синтаксис диаграмм вариантов использования, проверено 14 ноября 2026 года
Редакция NEQL · материал общего информационного характера. Обновлено 14 ноября 2026.
Оригинал статьи: https://neql.org/blog/vscode-mermaid-usecase-preview