字面块按照您在源代码中看到的方式准确显示您编写的文本。字面文本被视为预格式化文本。该文本以固定宽度的字体呈现,且保留了换行符。只有在文档转换时,特殊字符和标注才会被替换。

字面样式可以通过以下任何方法应用到内容中:

  • 将一个段落的第一行缩进一个或多个空格,

  • 通过属性列表对块设置`literal`风格,或者

  • 将内容包裹在一对字面块定界符(....)内。

缩进方法

当一行文本以一个或多个空格开始时,它会被显示为一个原样区块。这种方法是插入简单代码片段的一种简便方式。

使用缩进指示文本字面值
Unresolved directive in literal-blocks.adoc - include::example$literal.adoc[tag=indent]

使用缩进指示文本字面值的结果如下所示。

Unresolved directive in literal-blocks.adoc - include::example$literal.adoc[tag=indent]

字面风格语法

通过在块上使用属性列表设置样式属性`literal`,可以将文字样式应用于一个块,例如一个段落。

字面样式语法
Unresolved directive in literal-blocks.adoc - include::example$literal.adoc[tag=style]

字面样式语法的结果如下呈现。

Unresolved directive in literal-blocks.adoc - include::example$literal.adoc[tag=style]

限定的文本块

最后,你可以通过在你想要渲染为文字的内容外围加上一对文字块分隔符(....)来实现。当内容包含空行时,这种方法特别有用。

限定字面块语法
Unresolved directive in literal-blocks.adoc - include::example$literal.adoc[tag=block]

限定字面块语法 的结果在下面呈现。

Unresolved directive in literal-blocks.adoc - include::example$literal.adoc[tag=block]

请注意,在输出中,加粗文本格式并没有应用于文本,三个连续的句点也没有被替换为省略号Unicode字符。