Я знаю, что можно использовать markdown внутри комментариев, и doxygen может это понять. Но мне нужно знать, можно ли создать документацию в формате уценки?
Мне нужна эта документация, которая будет создана из файлов С++.
Создавать документацию как файлы разметки с помощью doxygen
Ответ 1
Я знаю, что этот вопрос старый, но, похоже, доступен новый инструмент: https://www.npmjs.com/package/doxygen2md
Ответ 2
Я не знаю ничего, что будет делать это напрямую, но у doxygen есть возможность выводить XML-документ с помощью генератора XML.
Существуют различные проекты, которые могут затем использовать упомянутые данные XML для их преобразования, одним из самых простых, которые мне известны, является Breathe, который используется для преобразования документов XML в то, что Sphinx может использовать для вывода документации с использованием doxygen в качестве препроцессор так сказать.
Код для Breathe может быть достаточно простым для использования в качестве отправной точки для генерации файлов Markdown вместо файлов ReStructuredText, которые требуются Sphinx. Я не смотрел на код для Breathe, но я использовал его для некоторых крупных проектов.
Ответ 3
Сгенерируйте XML с помощью doxygen http://www.doxygen.nl/manual/customize.html#xmlgenerator.
Используйте PanDoc http://pandoc.org/ для конвертации XML в Markdown.