[AsciiDoc]_[项目管理]_[如何把adoc格式转换为docx]

场景

1. 再改用 adoc 格式来写需求文档后，并通过 asciidoctor-pdf 生成 PDF 格式。而 asciidoctor 命令工具并不能生成 docx 格式. 那么如果如何把 adoc 格式转换为 docx?

说明

1. asciidoctor-pdf 可以生成 ODF 格式，但是如果生成中文需要下载字体, 还要一个样式文件，参考^[2]。有人会觉得麻烦，如果生成 docx 格式就不需要字体文件.

2. 但是需要说明的是 PDF 格式比 docx 更小，打开和阅览更快。一般情况样式比较多的 docx 文件大小是 PDF 的好几倍，所以推荐的还是生成 PDF 作为需求文档更合适。

3. asciidoctor 命令可以转换为docbook格式, 一种 XML 格式。之后再用 pandoc 其他工具转换为 docx. 即借用中间格式转换的办法。只是当 docbook 格式太大的时候(adoc也比较大)转换为 docx 就很慢。

4. pandoc 是一个第三方工具，可以从 pandoc 下载安装。

例子

test.adoc

= 场景

1. 测试 `段落1`
2. 测试 #段落2#

== 场景1

image::1.png[]  

== 场景2

1. 测试段落

图片

运行命令

@rem 使用asciidoctor转换adoc为docbook格式
asciidoctor -b docbook test.adoc -o test.xml
@rem 使用pandoc转换为docx格式
pandoc -f docbook -t docx -o test.docx test.xml

参考

1. 使用AsciiDoctor-pdf作为需求文档生成工具的一些问题

2. 适合写书写需求文档的纯文本轻量级标记语言

3. pandoc

4. Render Asciidoc to docx

5. converting-from-asciidoc-to-google-docs-and-ms-word