asciidoc转markdown

本文介绍了一种将Asciidoc文档转换为Markdown格式的方法,首先使用AsciidocFX工具将Asciidoc转换为DocBook,再利用pandoc将DocBook转换为Markdown,此过程保留了原始文档的格式,尽管某些复杂标记可能无法完全转换。

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

       目前正在做elasticsearch的官方文档翻译工作,翻译的过程中,在想是不是可以把已经翻译的部分文档放到网站上,提前分享给大家,因为现在github上的文档现在都是asciidoc格式的,但是网站支持的是markdown的,所以需要asciidoc转到markdown格式,在网上搜索了下,貌似没有直接转的工具,但是看到很多曲线救国方案,我把自己转的过程梳理出来,供大家参考。

       整体思路是使用AsciidocFX工具把asciidoc转换成DocBook格式的,然后通过pandoc把DocBook转换成markdown格式的,最终生成的markdown格式的文档格式和原始的asciidoc文档一致,只是有些标记不能转换出来,毕竟asciidoc更加强大,支持的标记更丰富,以后的趋势应该是asciidoc,大家可以看到基本上开源的项目文档都是asciidoc格式的了。

       工具下载地址:

        AsciidocFX:https://asciidocfx.com/#truehow-to-install-asciidocfx  这是官网地址,上面写的很详细

        pandoc:http://www.pandoc.org/installing.html  这是官网地址,上面写的很详细,mac的话,建议用home brew方式安装,上面也有说明,这是一个命令行工具,命令在网上和官网都有说明

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值