Полезные расширения VScode для работы с документацией

[korsikanec]

Merimand упомянули, а про Plantuml не сказали)

[dedmagic]

большинство обучающих материалов, которые я написал, оформлены в виде README-файлов

Называть все файлы одинаково вместо того, чтобы название отражало содержимое? Странное решение...

[Mauzzz0]

Наверное, под «в виде README-файлов» автор имел в виду все же расширение .md, а не само название файла :)

[dedmagic]

Ну если бы было написано "в markdown-формате", то и вопросов бы не возникло :)

[ritorichesky_echpochmak]

Foam (для любителей Obsidian) и httpYac (аналог плагина HTTP request, с CLI пригодным для автотестов) с выполнением запросов прямо из MD-документации.

Ещё для любителей веба можно приловчиться документацию по коммиту через Hugo выгонять в статичный сайт и хостить хоть на GitHub. И тогда править документацию можно прям в GitHub/GitLab в их WebIDE

[bubn0ff]

Вместо Draw.io Integration пользуюсь Miro. И то, что это не для VS Code - не страшно. Мне лично так проще - переключился и строишь диаграммы, потом снова переключился - опять в редакторе кода. Всё зависит от удобства для каждого конкретного разработчика.

[SabMakc]

В Draw.io Integration есть очень интересная фича с редактированием файлов *.drawio.svg - получается SVG-файл (т.е. картинка/схема) для markdown-документа и drawio-файл для редактирования непосредственно в VSCode.