Java 23 Markdown文档注释外部链接渲染问题咨询

IntelliJ IDEA 渲染异常问题 #

这属于IDE对Java 23 Markdown注释特性的支持滞后问题，大概率是待修复的Bug：

• Java 23通过JEP 467引入Markdown文档注释支持，但JetBrains对该特性的适配尚未完全完成，尤其是外部链接的渲染逻辑存在缺陷。
• 你遇到的「仅HTML链接正常渲染」的情况，说明IDE的Markdown解析器还未正确兼容标准Markdown的链接语法，只能识别HTML格式的<a>标签链接。
• 建议去JetBrains官方Issue追踪平台搜索同类问题，若没有相关反馈，可提交新的Bug报告，附上你的测试环境和代码示例。

Maven Javadoc Plugin 3.10.0 跳过链接问题 #

这同样属于插件的适配滞后问题，而非你遗漏了规则：

• 尽管Apache Maven Javadoc Plugin 3.10.0宣称支持JDK 23，但它的Markdown注释解析逻辑未同步JEP 467的规范，导致无法识别标准Markdown格式的外部链接，直接跳过处理。
• 临时解决方案可继续使用HTML格式链接，或尝试插件的快照版本（若有），确认是否已修复该问题。
• 也可去Apache Maven官方Issue列表查看相关反馈，确认是否为已知Bug。

规则遗漏排查说明 #

JEP 467定义的Markdown注释支持是受限子集，但其中明确包含标准Markdown的链接语法（[链接文本](URL)），因此你并未遗漏相关规则。

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