diff --git a/docs/source/tags/include.md b/docs/source/tags/include.md
index 02e88265c..930561099 100644
--- a/docs/source/tags/include.md
+++ b/docs/source/tags/include.md
@@ -72,6 +72,8 @@ This way, you don't need to escape `"` in the filename expression.
## Jekyll include
+{% since %}v9.33.0{% endsince %}
+
[jekyllInclude][jekyllInclude] is used to enable Jekyll-like include syntax. Defaults to `false`, when set to `true`:
- Filename will be static: `dynamicPartials` now defaults to `false` (instead of `true`). And you can set `dynamicPartials` back to `true`.
@@ -81,24 +83,28 @@ This way, you don't need to escape `"` in the filename expression.
For example, the following template:
```liquid
-{% include name.html header="HEADER" content="CONTENT" %}
+{% include article.html header="HEADER" content="CONTENT" %}
```
-`name.html` with following content:
+`article.html` with following content:
```liquid
-
-{{include.content}}
+
+
+ {{include.content}}
+
```
Note that we're referencing the first parameter by `include.header` instead of `header`. Will output following:
```html
-
-CONTENT
+
+
+ CONTENT
+
```
[extname]: ../api/interfaces/liquid_options_.liquidoptions.html#Optional-extname
[root]: ../api/interfaces/liquid_options_.liquidoptions.html#Optional-root
-[dynamicPartials]: ../api/interfaces/liquid_options_.liquidoptions.html#dynamicPartials
-[jekyllInclude]: ../api/interfaces/liquid_options_.liquidoptions.html#jekyllInclude
+[dynamicPartials]: ../api/interfaces/liquid_options_.liquidoptions.html#Optional-dynamicPartials
+[jekyllInclude]: ../api/interfaces/liquid_options_.liquidoptions.html#Optional-jekyllInclude
diff --git a/docs/source/tutorials/options.md b/docs/source/tutorials/options.md
index ea3330d36..d9db59b7c 100644
--- a/docs/source/tutorials/options.md
+++ b/docs/source/tutorials/options.md
@@ -52,6 +52,29 @@ Setting `dynamicPartials: false`, LiquidJS will try to include the file named `f
{% note warn Common Pitfall %}
LiquidJS defaults this option to true to be compatible with shopify/liquid, but if you're from eleventy it's set to false by default (see Quoted Include Paths) which I believe is trying to be compatible with Jekyll.{% endnote %}
+## Jekyll include
+
+{% since %}v9.33.0{% endsince %}
+
+[jekyllInclude][jekyllInclude] is used to enable Jekyll-like include syntax. Defaults to `false`, when set to `true`:
+
+- Filename will be static: `dynamicPartials` now defaults to `false` (instead of `true`). And you can set `dynamicPartials` back to `true`.
+- Use `=` instead of `:` to separate parameter key-values.
+- Parameters are under `include` variable instead of current scope.
+
+For example in the following template, `name.html` is not quoted, `header` and `"HEADER"` are separated by `=`, and the `header` parameter is referenced by `include.header`. More details please check out [include][include].
+
+```liquid
+// entry template
+{% include article.html header="HEADER" content="CONTENT" %}
+
+// article.html
+
+
+ {{include.content}}
+
+```
+
## extname
**extname** defines the default extension name to be appended into filenames if the filename has no extension name. Defaults to `''` which means it's disabled by default. By setting it to `.liquid`:
@@ -123,3 +146,4 @@ Parameter orders are ignored by default, for ea `{% for i in (1..8) reversed lim
[layout]: ../tags/layout.html
[wc]: ./whitespace-control.html
[intro]: ./intro-to-liquid.html
+[jekyllInclude]: ../api/interfaces/liquid_options_.liquidoptions.html#Optional-jekyllInclude
diff --git a/docs/source/zh-cn/tags/include.md b/docs/source/zh-cn/tags/include.md
index 934b57085..d0afde912 100644
--- a/docs/source/zh-cn/tags/include.md
+++ b/docs/source/zh-cn/tags/include.md
@@ -72,6 +72,8 @@ title: Include
## Jekyll include
+{% since %}v9.33.0{% endsince %}
+
[jekyllInclude][jekyllInclude] 用来启用 Jekyll-like include 语法。默认为 `false`，当设置为 `true` 时：
- 默认启用静态文件名：`dynamicPartials` 的默认值变为 `false`（而非 `true`）。但你也可以把它设置回 `true`。
@@ -81,24 +83,28 @@ title: Include
例如下面的模板：
```liquid
-{% include name.html header="HEADER" content="CONTENT" %}
+{% include article.html header="HEADER" content="CONTENT" %}
```
-其中 `name.html` 的内容是：
+其中 `article.html` 的内容是：
```liquid
-
-{{include.content}}
+
+
+ {{include.content}}
+
```
注意我们通过 `include.header` 引用第一个参数，而不是 `header`。输出如下：
```html
-
-CONTENT
+
+
+ CONTENT
+
```
[extname]: ../../api/interfaces/liquid_options_.liquidoptions.html#Optional-extname
[root]: ../../api/interfaces/liquid_options_.liquidoptions.html#Optional-root
-[dynamicPartials]: ../../api/interfaces/liquid_options_.liquidoptions.html#dynamicPartials
-[jekyllInclude]: ../../api/interfaces/liquid_options_.liquidoptions.html#jekyllInclude
+[dynamicPartials]: ../../api/interfaces/liquid_options_.liquidoptions.html#Optional-dynamicPartials
+[jekyllInclude]: ../../api/interfaces/liquid_options_.liquidoptions.html#Optional-jekyllInclude
diff --git a/docs/source/zh-cn/tutorials/options.md b/docs/source/zh-cn/tutorials/options.md
index 2fa2f16e3..aaa51f5fe 100644
--- a/docs/source/zh-cn/tutorials/options.md
+++ b/docs/source/zh-cn/tutorials/options.md
@@ -47,9 +47,32 @@ const engine = new Liquid({
{% liquid foo.html %}
```
-{% note warn Common Pitfall %}
+{% note warn 常见陷阱 %}
LiquidJS 把这个选项默认值设为 true 以兼容于 shopify/liquid，但如果你在使用 eleventy 它会设置默认值 false （参考 Quoted Include Paths）以兼容于 Jekyll。{% endnote %}
+## Jekyll include
+
+{% since %}v9.33.0{% endsince %}
+
+[jekyllInclude][jekyllInclude] 用来启用 Jekyll-like include 语法。默认为 `false`，当设置为 `true` 时：
+
+- 默认启用静态文件名：`dynamicPartials` 的默认值变为 `false`（而非 `true`）。但你也可以把它设置回 `true`。
+- 参数的键和值之间由 `=` 分隔（本来是 `:`）。
+- 参数放到了 `include` 变量下，而非当前作用域。
+
+例如下面的模板中，`name.html` 没有带引号，`header` 和 `"HEADER"` 以 `=` 分隔，`header` 参数通过 `include.header` 来引用。更多详情请参考 [include][include]。
+
+```liquid
+// entry template
+{% include article.html header="HEADER" content="CONTENT" %}
+
+// article.html
+
+
+ {{include.content}}
+
+```
+
## extname
**extname** 定义了默认的文件后缀，当传入文件名不包含后缀时自动追加。默认值是 `''` 也就是说默认是禁用的。如果设置为 `.liquid`：
@@ -120,3 +143,4 @@ LiquidJS 把这个选项默认值设为 true 以兼容于 shopify/l
[layout]: ../tags/layout.html
[wc]: ./whitespace-control.html
[intro]: ./intro-to-liquid.html
+[jekyllInclude]: ../api/interfaces/liquid_options_.liquidoptions.html#Optional-jekyllInclude