AsciiDoc 是一种轻量级标记语言，类似于 Markdown。AsciiDoc 超越了 Markdown，支持起草文章、技术手册和书籍所需的所有结构化元素。O'Reilly 的几位作者，包括 Matthew McCullough、Tim Berglund 和 Matt Neuburg，都曾使用它为那套标志性的技术图书馆撰写书籍。AsciiDoc 完全可以作为 DocBook 的简写替代品，它也可以输出 DocBook。

可以这样理解 AsciiDoc 和 DocBook 的关系：AsciiDoc 之于 DocBook，正如 RelaxNG Compact 之于 XML Schema。使用 AsciiDoc，您可以去掉尖括号（即 XML），但保留其语义。

这是一个用 AsciiDoc 编写的文档示例，显示在它生成的输出上方。

（您不想看到这个示例的 DocBook 版本。我们只能说，屏幕上没有足够的空间向您展示。）

Python 编写的 AsciiDoc 项目是 AsciiDoc 语法的唯一实现……直到“医生”的到来。

Asciidoctor 是第一个用另一种语言（在这种情况下是 Ruby）实现 AsciiDoc 语法的项目。它是一个开源库（MIT 许可），以 RubyGem 的形式发布到 rubygems.org。该项目最近已迁移到 GitHub 上的 Asciidoctor 组织，以维持其快速增长。

虽然 Asciidoctor 旨在完全兼容 AsciiDoc 语法（除了一些例外，已在项目 README 中注明），但它不仅仅是一个克隆。

Asciidoctor 使用一套内置的 ERB 模板来生成与 AsciiDoc 产生的输出在结构上等同的 HTML 5 和 DocBook 4.5 输出。任何这些模板都可以被用 Ruby 生态系统中任何可用的模板语言编写的自定义模板替换。自定义模板渲染由 Tilt 模板抽象库处理，这是一个由另一位 GitHub 用户 Ryan Tomayko 创建的项目。

利用 Ruby 堆栈不仅仅是 Asciidoctor 的一个好处。与 AsciiDoc Python 实现不同，Asciidoctor 以离散的步骤解析和渲染源文档。这使得渲染文档成为可选的，并使 Ruby 程序有机会通过与 Asciidoctor 组装的文档对象模型进行交互来提取、添加或替换文档中的信息。开发人员可以使用 Ruby 编程语言的全部功能来操作文档内容。

要全面介绍 Asciidoctor，就不能不提它的**速度**。尽管这不是项目最初的目标，但 Asciidoctor 的速度却令人惊叹。它加载、解析和渲染文档的速度比 Python 实现**快至少 25 倍**。这对开发者的生产力来说是个好消息，对需要渲染 AsciiDoc 标记的 GitHub 或任何服务器端应用程序来说也是个好消息。Asciidoctor 还提供了多个级别的安全性，进一步证明了其适合服务器端部署。

Asciidoctor 的使用不仅限于 Ruby 社区。得益于 Ruby 到 JVM 的移植版 JRuby，Asciidoctor 也可以在 Java 应用程序中使用（并最终在 Apache Maven 等 Java 构建工具中使用）。Asciidoctor 还附带了一个由 Red Hat 的 Jason Porter 编写的命令行界面 (CLI)。Asciidoctor CLI `asciidoctor` 是 AsciiDoc Python 分发版中的 `asciidoc.py` 脚本的直接替代品。

AsciiDoc 的未来一片光明。尽管它是一个成熟的、已有 10 年历史的标记语言，但 AsciiDoc 的采用率从未如此强劲。开发人员有很多关于如何改进和扩展 Asciidoctor 的想法，其中一些甚至超出了 AsciiDoc 语法本身。

愉快地编写文档！

在花了两天时间将几篇完整的技术教程转换为 AsciiDoc 并深入研究其功能后，我现在可以称得上精通 AsciiDoc 了。

AsciiDoc 是一种轻量级但功能强大的标记语言，它应有尽有

这才是一门值得用来写书的轻量级标记语言！

可以这样理解

对于基本格式化，Markdown 和 AsciiDoc 的外观非常相似，这使得 AsciiDoc 成为 Markdown 的一个即插即用、无需思考的替代品（在简洁性和平滑迁移方面都是如此）。然而，AsciiDoc 的语法似乎永无止境。事实上，它确实没有尽头，因为它（可以）相当容易地进行扩展（和调整）。

那 Docbook 呢？啊！AsciiDoc 的妙处在于，您仍然可以生成 Docbook，而无需付出任何痛苦，也无需牺牲任何功能。也许 AsciiDoc 应该采纳这个口号

我可以列出 AsciiDoc 支持的所有功能，但一个展示比任何语言都更能说明问题：http://powerman.name/doc/asciidoc

回到我的实验……

我有机会认真评估和比较了几种重要的轻量级标记语言：reStructuredText（及其补充 Sphinx）、Textile 和 AsciiDoc。毫无疑问，AsciiDoc 是赢家。如果软件中有“万无一失”这样的说法，那 AsciiDoc 就是了。

我首先将一篇完整的技术教程转换为 reStructuredText。花费了大约 3 个小时才艰难地弄懂语法并完成转换，但仍然存在一些遗漏。语法实在古怪（为什么痴迷于反引号和冒号？），而且很难记住。总的来说，让人感觉不舒服。我相当沮丧，准备放弃了。

睡前，一丝好奇心驱使我去尝试 AsciiDoc。在 15 分钟内，我就完成了整个文档的转换。此外，我还获得了 HTML、PDF、纯文本、ePub 和 Docbook 的输出。我甚至开始尝试额外的格式化和组织功能。我感觉像是找到了文档的圣杯。

这是那个实验的结果

文档可以很简单也很有趣。谁能想到呢？

我对 AsciiDoc 的兴奋程度与我对 git 的兴奋程度相当（两者结合简直是天作之合）。还有很多东西有待探索。我强烈鼓励大家去试试。AsciiDoc 甚至在 github（和 gists）上被支持为一种标记格式，非常容易上手。