24

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?

Ciro Santilli OurBigBook.com
  • 347,512
  • 102
  • 1,199
  • 985
Laurent T
  • 1,070
  • 4
  • 13
  • 25

5 Answers5

43

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)

Richard Dallaway
  • 4,250
  • 1
  • 28
  • 39
11

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.

KimCM
  • 1,411
  • 11
  • 14
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.

Erik Pragt
  • 13,513
  • 11
  • 58
  • 64
  • 3
    I have a quite extensive suite here https://github.com/bodiam/markdown-to-asciidoc/tree/master/src/test/resources/com/laamella/markdown_to_asciidoc Run them on Pandoc, and all failings tests are issues. – Erik Pragt Jun 25 '15 at 14:31
2

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.

Dan Allen
  • 2,418
  • 1
  • 16
  • 13
  • Speaking from experience as a technical writer and user of the package, kramdown-asciidoc is far more suited to converting Markdown to Asciidoc than Pandoc. If you're interested, I wrote a post on the package that gives a reasonably in-depth look at the package and how to use it: https://matthewsetter.com/convert-markdown-to-asciidoc-with-kramdown-asciidoc/ – Matthew Setter Dec 06 '19 at 11:29
0

This is the best pandoc solution:

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

The version I used is pandoc 2.11.0.4.

71GA
  • 1,132
  • 6
  • 36
  • 69