如何在Jekyll的Asciidoc中使用Liquid渲染HTML组件？

方法1：全局开启Liquid预处理 #

在Jekyll的_config.yml中添加jekyll-asciidoc的相关配置，让Asciidoc文件先经过Liquid引擎处理：

asciidoc:
  extensions:
    - asciidoctor-liquid
  attributes:
    liquid: true

配置完成后，就能在.adoc文件中直接使用Liquid代码，比如：

{% include component.html %}

方法2：用Asciidoc passthrough块嵌入 #

如果不需要全局开启，可通过Asciidoc的passthrough块（用++++包裹）直接嵌入Liquid代码，写法如下：

++++
{% include component.html %}
++++

这种方式会让Asciidoc解析器跳过包裹内容的处理，直接交给Jekyll的Liquid引擎渲染。

注意点 #

• 确保jekyll-asciidoc插件版本足够新，支持上述功能；
• 使用passthrough块时，注意内部Liquid代码的语法正确性，避免和Asciidoc语法冲突。

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