示例块

在本页面中,您将学到:

  • 如何使用AsciiDoc标记示例。

示例语法

示例段落或分隔块对于直观地区分说明概念的内容或显示操作结果非常有用。示例可以包含任何类型的内容和AsciiDoc语法。示例内容会应用正常的替换。

示例段落

如果示例内容是连续的,即没有空行中断,块名称example可以直接放在文本顶部的属性列表([])中。

示例1. 示例段落语法
.可选标题
[example]
这是一个示例段落。

这是示例1的结果。

可选标题
这是一个示例段落。

分隔示例块

如果示例内容包含由空行分隔的元素,请将内容放置在由四个等号(====)组成的分隔符行之间。在使用分隔块时,不需要设置块名称。

示例2. 分隔示例块语法
.拟声词
====
书掉在地板上发出了*砰*的声音。

他能听到鸽子在松树枝上*咕咕*的声音。
====

这是示例2的结果。

拟声词

书掉在地板上发出了的声音。

他能听到鸽子在松树枝上咕咕的声音。

复杂的警示使用分隔示例块语法。