使用gitbook快速把md文件转成html

学习pyqt的最大的障碍就是没有中文文档。

在笔者不懈努力下发现宝藏了。pyqt5的中文手册下载

这个链接指向的是一个github地址。笔者将他下载下来之后呢,发现都是md文件。很讨厌每次都是用md软件打开帮助文档,所以,就想着怎么将md转换成成常用的帮助文档类型,比如html。于是有了此篇博文。

使用gitbook快速把md文件转成html

安装

npm i gitbook gitbook-cli -g 

创建目录.md文件

简单说就是将所有的要转换的md文件都放在doc文件夹下面。在跟doc文件夹同级的位置新建一个如help.md的文件,该文件内容格式大致如下:

# pyqt5中文手册

* [一级标题](text1.md)
* [一级标题](doc/text1.md)
    * [二级标题(doc/text/text1.md)
    	*[三级标题](..) 

类似以上的内容
例如你在* [一级标题](doc/text1.md)这里后面的引用地址写了doc/text1.md,最终运行命令后,会生成一个doc目录,doc目录里会创建1个text.md, 而且这个一级标题会指向这里。

生成md文件

如果我们自己要新建一个帮助手册,那么这个步骤要看下,否则可省略

gitbook init

这个命令会生成相应的md的文件,然后在相应的文件里,写你的内容即可

md转html

gitbook build

生成一个_doc目录,打开就可以看到你html文件了。

 

 

 

发布了176 篇原创文章 · 获赞 45 · 访问量 23万+
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章