Is there any way to convert markdown to asciidoc (or be able to produce the same HTML output)?

Question

Here is my problem, normally I convert asciidoc documents to HTML (or more precisely asciidoc --> docbook --> html) but here I've been given a markdown document.

I would like to be able to produce an HTML document from that markdown document that would look the same as if it was coming from an asciidoc OR be able to convert this markdown to asciidoc somehow?

Answer 1

Try to use Pandoc to convert the markdown source to docbook xml.

From there, it should be possible to convert the docbook xml to html with the same technique as you used before for the asciidoc input, e.g. use the same xslt-translations for docbook->html.

Answer 2

To echo @akosma comment, pandoc does indeed have AsciiDoc support:

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

You can also go directly from Markdown to HTML:

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

(The -S just to produce nice curly quotes and other Smart typographical changes)

Answer 3

In my experience, Pandoc doesn't convert a lot of documents correctly, so I've created my own converter, which can be found here.

It's a simple tool written in Java which has been successfully used to convert a lot of documents, including the manual from Geb.

Answer 4

I'll throw another one into the mix. I've written a custom converter for Kramdown that converts Markdown to AsciiDoc.

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

The benefit of this library is that Kramdown is extremely good at parsing GitHub-flavored Markdown, which is likely the Markdown people are most interested converting from.