如何在autocompletion文档中添加可点击链接？原生HTML被转义

这个问题提得好！原生HTML被转义确实是出于安全考量（防止XSS攻击），完全合理。下面给你几个合规又安全的实现方案，具体看你用的是什么自动补全文档系统：

1. 用Markdown链接语法（最通用的解法） #

大多数自动补全/文档系统（比如VS Code的智能提示、GitHub的自动补全、各类文档平台）本身就支持Markdown。别用原生HTML，直接用标准的Markdown链接格式就行：
[链接文本](目标URL)

举个例子，如果你在开发VS Code扩展，定义补全项的时候可以把文档内容写成Markdown字符串：

const completionItem = new vscode.CompletionItem('calculateTotal');
completionItem.documentation = new vscode.MarkdownString(
  '查看函数详细用法：[API参考文档](https://docs.example.com/calculateTotal)'
);

系统会把这个渲染成可点击的链接，不会转义——因为Markdown解析是内置的，而且经过安全处理。

2. 利用平台专属的链接API #

有些IDE或文档工具提供专门的API来添加可交互链接，不用依赖HTML。比如JetBrains系列IDE（像IntelliJ）的SDK里，定义补全文档时可以直接创建链接元素，既绕开了原生HTML的转义问题，又能实现点击效果。去查你用的平台官方文档，找这类专门的方法，它们都是为了兼容和安全设计的。

3. 检查是否有HTML白名单配置（自托管系统适用） #

如果你用的是自托管的自动补全/文档工具，可能有配置项允许白名单特定的HTML标签和属性（比如<a href>）。公共系统一般不会开这个（怕安全风险），但内部工具可能有相关设置。如果要开，记得只添加必要的规则，保证安全性。

总之，尽量别用原生HTML，用系统原生支持的格式才是最安全可靠的做法。

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