什么是 Asciidoc

1. 什么是 Asciidoc

1.1. luikore

类似于 wikipedia 编辑语法的文档生成 / 写作语言输出格式支持 html, epub(当然 epub 就是包着的 html…), pdf(当然 pdf 就是打印…), deck.js, docbook, man, latex 等可以用于注释用来生成文档, 例如 doclet, rdoc 都可以选择 asciidoc 安装容易, 源文件易读, 功能比 markdown 丰富很多, 容易扩展 (markdown 的解析器很难扩展, 扩展了也经常有莫名奇妙的 bug, 但 asciidoc 的语法设计就很容易扩展, asciidoctor 的扩展点也非常简单)

1.2. weakish

有些人觉得 DocBook XML 不直观, 因此开发了 AsciiDoc. 不过 AsciiDoc 的语法很复杂, 当然比 DocBook XML 简短, 但未必简单。就好像 Perl 比 Java 简短多了, 但未必比 Java 简单。不过貌似 DocBook XML 不像 Java 一样有很多强大的 IDE, 所以还是有不少人偏好 AsciiDoc. 最初是用 Python 实现的。后来又有人用 Ruby 实现了, 叫 Asciidoctor.Asciidoctor 一边在文档里抨击 MarkDown 有太多方言, 互相不兼容, 一边又改了 AsciiDoc 的语法。(不仅加了很多新语法, 还去掉了一些语法, 各 MarkDown 方言至少极少去掉始祖 MarkDown 的语法。)

1.3. xx

不回答是什么, 在 java 社区里, 使用 asciidoc 的还是很多的, 包括 spring 社区的很多项目都采用 asciidoc 来写文档。

有个使用 java 编写的 asciidoc gui 也挺不错

asciidocfx/AsciidocFX · GitHub

1.4. nolanzz

简单看了下文档, 感觉可以解决 2 个 markdown 的痛点:

原生支持修改图片大小
表格支持合并单元格