Last active
March 6, 2024 02:35
-
-
Save cheungnj/38becf045654119f96c87db829f1be8e to your computer and use it in GitHub Desktop.
Convert asciidoc to Github Flavored Markdown
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
# 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 |
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.
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
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