AsciiDoc 现在主要的实现是 Ruby 写的 AsciiDoctor，有 Java 和 JS binding，主要的输出目标是 HTML，所以排版上就是网页那一套，也很灵活，可以加自己的 role (class) 和 CSS。它自己的文档就是用 AsciiDoc 生成的，当然用了 Antora 来组织起来。
我写的东西不需要很复杂的排版，所以对这方面要求不高，就不拿出来了。
整体上说，如果没有外部资源文件，单个 .adoc 文件可以直接当文本看，也可以用浏览器插件预览。
我是准备拿它写技术文档（手册，设计说明，使用教程。。。），然后生成pdf给其内部外部其他人。当然，如果是一个完整的html格式电子书也行。 主要就是这个需求。
技术文档可以考虑使用dita来编写，最新的4.0版本，projects组织和字体配置已经很简单了。 可重用，多发布多种格式，xml也比较友好
可选项很多。我先试试asciidoc。
看了一下 DITA 和 DocBook 的对比觉得有兴趣试一下，有啥开源的 DITA 出版方案吗？
开源方案大多用 DITA Open Toolkit ，也没发现其它免费方案了。开源的好处是可以集成到流水线，可以跟项目很好结合一起发布