用Asciidoc和Markdown来简化写作

AsciidocFX.png

自从看到Spring 的文档全部使用了Asciidoc 后，就更喜欢用它胜过之前用的Markdown。有个Asciidoctor 是这个文件格式的一个Ruby实现。另外，编辑器就是图片中的这个AsciidocFX，用JavaFX实现的，有导出HTML、PDF等功能，非常实用。

我比较喜欢的另一个功能是使用AsciiDoc来创建HTML幻灯片，见我之前写的文章—— 使用Asciidoctor和reveal.js制作炫酷的幻灯片 。

如果想把写好的文档放在网站上托管怎么办呢？其实现在GitHub上已经支持AsciiDoc格式了，另外可以把文档转换为Markdown格式的，目前还没找到合适的直接的转换工具，但可以曲线救国，先用AsciidocFX转存为Docbook格式，然后又两种方式把Docbook格式的文件转换为Markdown：

• 安装 pandoc ，运行下面的命令：

pandoc -f docbook -t markdown -s README.xml -o README.md

• 使用 这个在线工具 转换。注意，需要将docbook文件的扩展名改为db再上传

好了，有了Markdown格式的文件，就可以直接发布到简书这样的网站上了。