Простенький лендинг/wiki для вас и вашего проекта или как покорить Diplodoc'а и опубликовать на GitHub Pages

[tizian]

Документация без версионирования - это не дело.

[slonopotamus]

мы используем классический Markdown.

{% note info %}

И тут же лёгким движением руки Markdown превращается в чёрти что, не понимаемое никакими редакторами.

[TrueRuslan]

С выводами про классически Mardown поспешил, прошу прощения.

Данная конструкция создает следующую сноску:

Подробнее про синтаксис можно почитать здесь -> https://diplodoc.com/docs/ru/syntax/

[Still]

Интересно. У меня нечто похожее работает на Hugo + docsy theme

[itGuevara]

• Работа с изображениями - вставка картинок по ссылкам и локальных файлов

Документация - это про картинки \ схемы. Хотелось бы их вставлять в нативных форматах: visio, drawio, yEd и т.п. Как с этим?
Какие аналогичные проекты с поддержкой visio, drawio, yEd есть?

[TrueRuslan]

Еще не углубился поддерживаются ли нативные форматы. Уделю время и дополню статью примерами более функциональных возможностей.

Пока можете посмотреть на документацию Y.Cloud - https://github.com/yandex-cloud/docs, возможно, найдете примеры поддержки других форматов.