使用Doxygen时Markdown相对路径链接触发TK_EOF警告求助

项目目录结构 #

myproj/
    doc/installation.md
    tools/install/installation_ubu.md
    tools/install/installation_macos.md
    tools/install/installation_msys2.md
    Doxyfile

当前使用的Markdown链接（在doc/installation.md中） #

* Ubuntu: [installation_ubu](../tools/install/installation_ubu.md)
* MacOS: [installation_macos](../tools/install/installation_macos.md)
* Windows MSYS2: [installation_msys2](../tools/install/installation_msys2.md)

Doxygen警告信息 #

运行Doxygen时出现如下警告（Ubuntu使用1.8.17版本、MacOS使用1.9.8版本均触发）：

doc/installation.md:6: warning: unexpected token TK_EOF as the argument of ref
doc/installation.md:7: warning: unexpected token TK_EOF as the argument of ref
doc/installation.md:8: warning: unexpected token TK_EOF as the argument of ref

已尝试的调整方案 #

• 移除.md后缀：无警告，但Doxygen生成的HTML链接404，且Pycharm无法识别链接
• 将文件移至本地目录：无警告，Doxygen生成的PDF和HTML正常，但Pycharm无法识别链接
• 保留.md后缀且不移动文件：出现警告，但Doxygen生成的PDF、HTML正常，同时Pycharm可识别链接

需求 #

寻求能同时兼容Doxygen（无警告、链接正常）与Pycharm（可识别链接）的解决方案。

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