adoc(asciidoc)转为markdown的方法

本文介绍了一种将adoc(asciidoc)格式文档转换为markdown格式的方法,以适应不同平台的发布需求。通过安装pandoc和asciidoc,利用一系列命令行操作,包括从adoc转换为docbook,再从docbook转换为markdown,并解决了Unicode编码问题及硬换行符的调整。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

adoc(asciidoc)转为markdown的方法

转换原因

平时写文档,更倾向于使用asciidoc来写文档,因为他有更加丰富的功能。有的时候想发博客出去,但是一般网站的博客都是支持markdown的,所要有需求要将adoc转换为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

评论 4
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值