如何在Doxygen搭配Markdown时引入源代码文件？

针对你使用Doxygen 1.10.0时，想在Markdown文档里实现类似.dox文件\include命令引入源文件代码的需求，有几个直接可行的方案：

直接使用Doxygen命令 #

Doxygen处理Markdown文件时会优先解析内置命令，所以你可以直接在Markdown中写\include或@include命令，效果和.dox文件里完全一致：

比如在你的Markdown文档中添加：

### 示例代码：main.cpp
\include main.cpp

或者用@替代\（Doxygen两种语法都支持）：

### 示例代码：main.cpp
@include main.cpp

Doxygen会自动把指定文件的内容渲染成带语法高亮的代码块，和你在.dox里用\include的效果完全相同。

引入指定代码片段 #

如果不需要完整文件，只想引入特定行范围的代码，可使用带参数的\include命令：

### main.cpp核心逻辑（第10-25行）
\include[lines=10-25] main.cpp

配置文件注意事项 #

• 确保MARKDOWN_SUPPORT = YES（Doxygen 1.10.0默认已启用，无需额外修改）
• 如果源文件不在Markdown文档的同级目录，在Doxygen配置文件中设置INCLUDE_PATH指定源文件路径：

  INCLUDE_PATH = ./src  # 替换成你的实际源文件目录
  

内容的提问来源于stack exchange，提问作者BobMorane