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