在vscode中编写C语言代码,使用Doxygen规范
在注释中能识别@brief,@param等标签,但是不能完全显示md语法,截图如下:
下面是悬浮显示
有一部分md语法能正常显示一部分不能正常显示
图片中看起来像是没有换行
极客观点
项目管理
HarmonyOS
<p>,\n,<br>作为符一些语法尝试
代码语法可以
AI BotBETA在VS Code中使用Doxygen时，Markdown语法的支持可能受到Doxygen配置、VS Code扩展（如C/C++扩展或Doxygen插件）以及Doxygen版本本身的影响。以下是一些可能的解决方案和检查步骤，以帮助你在VS Code中更好地显示Doxygen注释中的Markdown语法：
首先，确认你正在使用的Doxygen版本支持Markdown语法。Doxygen从1.8.12版本开始支持Markdown语法，但可能不是所有Markdown特性都被支持。你可以通过查看Doxygen的官方文档或更新日志来确认这一点。
在Doxygen的配置文件（通常是Doxyfile）中，确保已经启用了Markdown支持。你可以查找MARKDOWN_SUPPORT配置项，并确保它被设置为YES。
如果你在使用VS Code的C/C++扩展或Doxygen插件，请确保这些扩展是最新的。开发者可能已经修复了与Markdown显示相关的问题，或者增加了对最新Doxygen版本的支持。
尽管Doxygen支持Markdown，但并非所有Markdown语法都被完全支持。特别是复杂的Markdown结构（如嵌套列表、表格、复杂的HTML标签等）可能在Doxygen中表现不佳。检查你的Markdown语法，看看是否有不被Doxygen支持的元素。
对于Doxygen不支持的Markdown语法，你可以考虑使用HTML作为替代。Doxygen支持HTML标签，并且通常可以更好地渲染它们。
Doxygen的官方文档和社区论坛是解决此类问题的宝贵资源。你可以搜索是否有其他用户遇到了类似的问题，并查看他们是如何解决的。
有时候，简单地重启VS Code可以解决渲染问题。这可以清除任何可能干扰Markdown显示的缓存或状态。
最后，检查VS Code的全局或工作区设置，看看是否有任何与Markdown渲染相关的设置可能影响了Doxygen注释的显示。
请注意，由于VS Code和Doxygen的集成可能涉及多个组件和配置，因此可能需要一些尝试和错误才能找到最适合你情况的解决方案。
3 回答1.7k 阅读✓ 已解决
2 回答2.2k 阅读
1 回答1.8k 阅读
706 阅读
