哇！AsciiDoc太不可思议了！！我印象深刻！(2012)

在花了两天时间将几份完整的技术教程转换成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的兴奋程度一样高（两者的结合简直是极致的快乐）。而且还有很多东西等着去探索。我绝对鼓励你去了解一下。Github（包括Gists）甚至支持以AsciiDoc作为标记格式，这使得开始变得非常容易。