adoc(asciidoc)轉爲markdown的方法
轉換原因
平時寫文檔,更傾向於食慾asciidoc來寫文檔,因爲他有更加豐富的功能。有的時候想法博客出去,但是一般網站的播客都是支持markdown的,所要有需求要將ado轉換爲markdown的形式發送到網站上去。
轉換方法
- install pandoc and asciidoc
sudo apt install pandoc asciidoc
- Convert asciidoc to docbook
asciidoc -b docbook foo.adoc
foo.xml will be output into the same directory as foo.adoc
- Convert docbook to markdown
pandoc -f docbook -t markdown_strict foo.xml -o foo.md
- Unicode symbols were mangled in foo.md. Quick workaround: (Unicode編碼會被搞亂,快速的變通辦法爲:)
iconv -t utf-8 foo.xml | pandoc -f docbook -t markdown_strict | iconv -f utf-8 > foo.md
- Pandoc inserted hard line breaks at 80 characters. Removed like so:
iconv -t utf-8 foo.xml | pandoc -f docbook -t markdown_strict --wrap=none | iconv -f utf-8 > foo.md