AsciiDoc 是一种特定的写作格式,并非出版格式。换句话说,它不像在文字处理器中写作那样所见即所得(WYSIWYG)。相反,你编写的是 AsciiDoc 源代码。然后你可以使用 AsciiDoc 处理器,比如 Asciidoctor,将 AsciiDoc 源代码转换成一种可发布的格式。你出版的是这个输出结果。

将AsciiDoc源代码转换是解释和美化内容的一个机会,可以从中获得超出输入内容的更多价值。将AsciiDoc源代码转换为另一种格式的工作由转换器处理。虽然语言和转换器之间有很强的关联,但这两个方面并没有显式地耦合在一起。

AsciiDoc处理器提供了几种内建的转换器,包括用于生成HTML和DocBook的转换器。要激活这些转换器之一,您需要在文档上设置后端(默认为html)。后端是一个关键字,用于告诉处理器您希望生成哪种输出格式。然后处理器选择能够生成该输出格式的转换器。例如,HTML转换器处理html后端以生成HTML输出。

一个AsciiDoc处理器实际上分为两个步骤工作。首先,它解析AsciiDoc文档。这种解析产生了一个结构化的文档,反映了书面结构并解释了所有有意义的标记。然后处理器将这个结构化文档传递给转换器,以将其转换成输出格式。

简而言之,处理器接受一个字符串(可能从文件中读取),将其解析成一个结构化文档,然后产生另一个字符串(可能写入到文件中)。