-
-
Save cheungnj/38becf045654119f96c87db829f1be8e to your computer and use it in GitHub Desktop.
# Adapted from https://tinyapps.org/blog/nix/201701240700_convert_asciidoc_to_markdown.html | |
# Using asciidoctor 1.5.6.1 and pandoc 2.0.0.1 | |
# Install pandoc and asciidoctor | |
$ sudo apt install asciidoctor | |
$ sudo wget https://github.com/jgm/pandoc/releases/download/2.0.0.1/pandoc-2.0.0.1-1-amd64.deb | |
$ sudo dpkg -i pandoc-2.0.0.1-1-amd64.deb | |
# Convert asciidoc to docbook using asciidoctor | |
$ asciidoctor -b docbook foo.adoc | |
# foo.xml will be output into the same directory as foo.adoc | |
# Convert docbook to markdown | |
$ pandoc -f docbook -t gfm foo.xml -o foo.md | |
# Unicode symbols were mangled in foo.md. Quick workaround: | |
$ iconv -t utf-8 foo.xml | pandoc -f docbook -t gfm | iconv -f utf-8 > foo.md | |
# Pandoc inserted hard line breaks at 72 characters. Removed like so: | |
$ pandoc -f docbook -t gfm --wrap=none # don't wrap lines at all | |
$ pandoc -f docbook -t gfm --columns=120 # extend line breaks to 120 |
Really useful. Many Thanks.
when I run the command iconv -t utf-8 foo.xml | pandoc -f docbook -t gfm | iconv -f utf-8 > foo.md, I get message as
iconv: conversion from char unsupported
iconv: try 'iconv -l' to get the list of supported encodings
iconv: conversion to char unsupported
iconv: try 'iconv -l' to get the list of supported encodings
This is a great shell.
For mac users: If you do a brew install on mac for both pandoc and asciidoctor, it works quite well. the following two did the job.
$ asciidoctor -b docbook foo.adoc
$ pandoc -f docbook -t gfm foo.xml -o foo.md
Thanks for the script.
I have updated it in my fork
I have shortened the script.
I have added --columns=120
option in earlier step itself. So last time commands can be removed.
Much obliged. The intermediate move to docbook with asciidoctor was the trick I needed.