How to I convery from asciidoc to Markdown format?
I have a bunch of asciidoc files in a folder. I have tried various tools like pandoc but they don’t have an option of converting from asciidoc to markdown.
Accepted Answer
You’ll need to first convert asciidoc to XML format and then to Markdown. In other words,
asciidoc ---> XML ---> markdown
First, install asciidoc
and pandoc
:
brew install asciidoc pandoc
Next, convert asciidoc document to markdown
asciidoc -b docbook file.adoc
This will create file.xml in XML format.
If you want to convert all *.adoc in a folder to markdown, you can use the following loop to do the tric:
for i in *.adoc; do asciidoc -b docbook $i; done
You can then use pandoc to convert the files to markdown format. For a single file, you would:
pandoc -f docbook -t markdown_strict file.xml -o file.md
To convert all files in the folder to markdown, use the loop again.
for i in *.xml; do pandoc -f docbook -t markdown_gfm $i -o $i.md; done
Clean up. If you don’t need asciidoc
or pandoc
anymore, you can clean them up:
brew uninstall asciidoc
brew uninstall pandoc