使用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文件了。