你可以使用include指令来包含另一个文件中的列表项内容,但有一些事情你需要注意。

请记住,include 指令必须单独定义在一行上。这在列表中会带来一个挑战,因为每个列表项必须以列表标记开始。我们可以通过使用内置的 empty 属性来启动列表项,然后在该行之后跟随 include 指令来引入实际内容来解决这个问题。

这是一个示例,展示如何使用`empty`属性和include指令来定义一个列表项,然后从另一个文件包含主要文本。

* {empty}
include::item-text.adoc[]

如果你能控制包含文件的内容,并确保它只包含相邻的文本行,这种技术效果很好。如果列表项不包含相邻行,列表可能会终止。因此,我们需要更多的语法。

如果你无法保证所有包含的行都将是相邻的,你会希望将包含指令放在一个开放块内。这样可以将所有包含的行保持在一起,封闭在块的边界内。然后,你可以使用列表续行(即 +)将这个块附加到列表项上。

这是一个如何将来自另一个文件的复杂内容包含到列表项中的例子:

* {空}
+
--
include::complex-list-item.adoc[]
--

参见列表项删除主要文本了解这种技术的另一个示例。