如何在Antora的AsciiDoc文件中引入并渲染含标签的HTML文件？

Antora支持直接引入并渲染自定义HTML，但需要用正确的语法避免内容被转义或当成纯文本处理，以下是可行方案：

方法1：使用pass::[]宏直接渲染HTML #

AsciiDoc的pass::[]宏会让内容直接传递到输出、不进行转义，适合直接引入HTML内容：

pass::[include::example$test.html[]]

这个写法会把test.html里的HTML内容直接注入页面，Antora会正常解析标签并渲染。

方法2：配置属性关闭HTML转义（全局/局部） #

如果需要批量处理HTML引入，可在文档开头添加属性设置，关闭HTML内容的转义：

:escape-html: false

include::example$test.html[]

设置escape-html: false后，所有直接包含的HTML文件内容都会被正常渲染，无需额外包裹。

你之前的方式无效的原因 #

• 直接include::example$test.html[]：AsciiDoc默认会转义HTML标签，将<h1>这类标签转换成实体字符（如<h1>），页面仅显示纯文本。
• 用代码块包裹：代码块会把所有内容当成纯代码展示，不会解析HTML标签，因此看到的是带标签的文本内容。

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