有没有办法将Markdown转换为AsciiDoc（或能够生成相同的HTML输出）？

Question

我的问题是，通常我将asciidoc文档转换为HTML（更准确地说是asciidoc --> docbook --> html），但这次我拿到了一个markdown文档。

我想要能够从markdown文档生成一个HTML文档，使其与来自asciidoc的文档外观相同，或者能够以某种方式将此markdown转换为asciidoc？

- Laurent T

Answer 1

回应@akosma的评论，pandoc确实支持AsciiDoc：

# Convert to AsciiDoc from Markdown:
$ pandoc -t asciidoc -f markdown file1.md > file1.txt

您可以直接从Markdown转换为HTML：

$ pandoc -S -t html -f markdown file1.md > file1.html

（使用 -S 选项只是为了产生漂亮的弯引号和其他智能排版变化。）

- Richard Dallaway

---

很不幸，我认为它在这一点上有些被遗弃了，例如它有一些明显的漏洞：https://github.com/jgm/pandoc/issues/4362 - Ciro Santilli OurBigBook.com

Answer 2

试试使用Pandoc将Markdown源代码转换成DocBook XML格式。

从这里开始，可以使用与您之前用于ASCIIDoc输入相同的技术将DocBook XML转换为HTML，例如使用相同的XSLT翻译进行DocBook->HTML转换。

- KimCM

---

最新版本的 Pandoc（在仓库中）允许进行 asciidoc <-> markdown 转换。 - Adrian Kosmaczewski

Answer 3

根据我的经验，Pandoc 无法正确地转换许多文档，因此我创建了自己的转换器，可以在这里找到。

这是一个简单的 Java 工具，已成功用于转换许多文档，包括Geb的手册。

- Erik Pragt

---

我在这里有一个相当广泛的套件 https://github.com/bodiam/markdown-to-asciidoc/tree/master/src/test/resources/com/laamella/markdown_to_asciidoc。在Pandoc上运行它们，所有失败的测试都是问题。 - Erik Pragt

Answer 4

我再加入一个内容。我编写了一个自定义转换器，可以将Markdown转换为AsciiDoc。

https://github.com/opendevise/kramdown-asciidoc

这个库的好处在于Kramdown非常擅长解析GitHub风格的Markdown，这可能是人们最感兴趣的转换格式。

- Dan Allen

---

从技术撰写者和软件包用户的角度来看，kramdown-asciidoc比Pandoc更适合将Markdown转换为Asciidoc。如果您感兴趣，我写了一篇关于该软件包的文章，其中详细介绍了该软件包的使用方法：https://matthewsetter.com/convert-markdown-to-asciidoc-with-kramdown-asciidoc/ - Matthew Setter

Answer 5

这是最佳的pandoc解决方案：

pandoc --atx-headers --verbose --wrap=none --toc --reference-links -s -f markdown -t asciidoc -o file.adoc README.md

我使用的版本是pandoc 2.11.0.4。

- 71GA