asciidoc

已经有很多简单标记语言了，不是吗？ （wiki，markdown等），这个asciidoc也是一种，它有什么新式武器吗？ 没有，它也是将带标记的text文件转换为html或其它格式，看起来很像docbook，不过git选择了asciidoc，而git是Linus大佬的项目，所以asciidoc还是有它的过人之处的。

简单的在Ubuntu下sudo apt-get install asciidoc就可以安装了，下载一个例子 http://www.methods.co.nz/asciidoc/faq.txt ，然后执行：
asciidoc faq.txt
就可以得到一份漂亮的内嵌css的html文档faq.html了，不错吧，试试看编辑一下txt文件，加入中文，都没有问题。

asciidoc的过人之处在于：
+ 格式简单，比docbook简单， 这种简单的格式带来的结果是asciidoc文件本身已经可以具备很好的文档可视性（一个docbook源文件看起来还是有些费劲的，被xml tag穿插的有些支离破碎），这可能对写文档的人连贯自己的思路有很大的好处。
+ 表达能力强，在格式简单的基础上，asciidoc的表达能力并不象某些wiki那么弱，比如asciidoc可以支持三种格式输入（doctype）：article，book和manpage（他们三种的基本语法是类似的），显然支持book就意味着asciidoc有较好的表达能力。
+ 工具易用， asciidoc本身的工具只有一个命令文件(asciidoc)，就支持三种格式（backend）输出：xhtml11/docbook/html4，一般情况下用xhtml11就很好用了，如果需要更复杂的输出，可以先转换到docbook，再用docbook toolchain做进一步转换。在命令行下使用 asciidoc -b backend -d doctype file 就可以了，通常 -b/-d都不用指定，缺省值分别为xhtml11和article，所以命令行使用就非常简单，比docbook的一整套toolchain用起来平易近人一些。

写了这么多优点，并不是说asciidoc没有缺点，通常一个新事物总是容易先看到优点，而在使用中再逐步看到缺点，我用的不多，所以不敢妄下结论，不过有一个缺点先提一下，它的官网上的User Guide文档写的不好，比较晦涩 :))