![](https://habrastorage.org/getpro/habr/upload_files/a0a/6f9/774/a0a6f977486737ca17dfec0ed276a807.png)
Как правило, работа с документацией — это последний этап любого проекта, связанного с данными (data science, data visualization и т. д.), проектированием и разработкой ПО. Речь о создании и редактировании библиотек, файлов README, обучающих материалов и др. Среди всех преимуществ VScode — его уникальная экосистема расширений. И особенно впечатляют те, что помогают работать с документацией. В этой статье поделюсь самыми полезными из них.
![Работа с диаграммой Draw.io с помощью расширения Draw.io Integration (иллюстрация: Rami Krispin) Работа с диаграммой Draw.io с помощью расширения Draw.io Integration (иллюстрация: Rami Krispin)](https://habrastorage.org/getpro/habr/upload_files/8cb/ca1/903/8cbca1903c369c2a5cbc2789fc9f0a2e.png)
Quarto
Quarto — крутая штука для работы с документацией под R, Python, Julia и Observable. Расширение позволяет создавать и редактировать разные виды документов в форматах HTML, PDF, MS Word, ePub. Это могут быть статьи, презентации, дашборды, сайты, блоги, книги и т. д.
Расширение Quarto для VScode поможет легко редактировать и рендерить QMD-файлы. В нем есть режим предварительного просмотра, который позволяет менять код документа и одновременно просматривать результат.
![Предварительный просмотр Quarto (иллюстрация: Rami Krispin) Предварительный просмотр Quarto (иллюстрация: Rami Krispin)](https://habrastorage.org/getpro/habr/upload_files/fb2/260/782/fb2260782179dd01b8f9ea41914c8afe.png)
Jupyter
Jupyter — один из самых популярных фреймворков для создания заметок, особенно в Python. Больше всего мне нравится использовать Jupyter для проектирования на Python и в качестве вспомогательной документации к его туториалам. В Jupyter отлично отображается разметка и форматирование кода на Python, плюс он поддерживается GitHub. А еще недавно я начал пользоваться Jupyter вместе с документацией Quarto для Python.
Расширение VScode Jupyter интегрирует заметки Jupyter в редактор VScode и поддерживает ipynb-файлы.
![Заметка Jupyter в VScode (иллюстрация: Rami Krispin) Заметка Jupyter в VScode (иллюстрация: Rami Krispin)](https://habrastorage.org/getpro/habr/upload_files/3ae/1fb/660/3ae1fb66079d1dfd30161c8ada3f721e.png)
Markdown All in One
Отчасти благодаря расширению Markdown All in One большинство обучающих материалов, которые я написал, оформлены в виде README-файлов. С этим расширением удобно редактировать документацию в формате Markdown. Оно располагает два окна рядом: редактор кода и тут же результат.
![Редактирование Markdown-файла с помощью расширения Markdown All in One (иллюстрация: Rami Krispin) Редактирование Markdown-файла с помощью расширения Markdown All in One (иллюстрация: Rami Krispin)](https://habrastorage.org/getpro/habr/upload_files/bca/ee7/df8/bcaee7df8f1a3b2123d7aa44c0f081a0.png)
Draw.io Integration
Мне нравится применять диаграммы и схемы, чтобы объяснить какие-то концепции в своих обучающих материалах. Основной инструмент, который я использую для этого, — Draw.io. Это инструмент с открытым исходным кодом для построения диаграмм. Сложные диаграммы я делаю в десктопной версии инструмента, и потом дорабатываю их в VScode с помощью расширения Draw.io Integration.
![Создание диаграммы Draw.io с помощью расширения Draw.io Integration (иллюстрация: Rami Krispin) Создание диаграммы Draw.io с помощью расширения Draw.io Integration (иллюстрация: Rami Krispin)](https://habrastorage.org/getpro/habr/upload_files/07c/918/be2/07c918be2b473acb17780eb8d1aeb2be.gif)
Mermaid
Хоть я и не пользуюсь Mermaid, но считаю этот инструмент очень полезным, если вам нужно создать структуру кодовой базы или динамическую диаграмму. В VScode есть два расширения для работы с файлами Mermaid — Mermaid Preview и Markdown Preview Mermaid Support.
![Редактирование диаграммы Mermaid в Markdown-файле с помощью расширения Markdown Preview Mermaid Support (источник) Редактирование диаграммы Mermaid в Markdown-файле с помощью расширения Markdown Preview Mermaid Support (источник)](https://habrastorage.org/getpro/habr/upload_files/5d1/923/164/5d1923164e0b8c67087d905f84daf4c0.png)
Безусловно, существует и множество других полезных расширений VScode. Делитесь ими в комментариях.
Happy documentation!