Уж не знаю, будет ли кому-то полезно, но узнал про такую классную штуку неделю назад как PlantUML.
https://plantuml.comЭто опенсорсный компонент для генерации диаграмм разного рода из кода с довольно простым синтаксисом. Пишешь код → результирующая схема рендерится в .png/.svg. Может как код встраиваться в имплементации Markdown (зависит от движка для обработки разметки).
Если сочетать с плагином для превью Markdown в live, то можно и диаграмму из кода отрисовывать на лету — пишешь и оно дорисовывается (у меня так с vim-markdown-preview получилось).
Где может быть полезно?
Проектные диаграммы, диаграммы для иллюстрации работы протоколов/техпроцессов конкретных, документация для ПО. Простор для фантазии огромный.