最简洁好用的文档构建工具Gitbook的使用

GitBook是一个基于 Node.js 的命令行工具，可使用 Github/Git 和 Markdown 来制作精美的电子书，目前gitbook可以支持生成静态html和pdf文档

安装使用

首先你需要安装node.js的环境，然后便可以使用npm脚手架工具下载安装gitbook工具

npm install gitbook-cli -g

或者使用cnpm淘宝的镜像源

cnpm install gitbook-cli -g

安装成功后，新建一个文件夹，此处为了方便演示，我们新建mybook文件夹

接着开始初始化gitbook项目

gitbook init

初始化成功后，可以看到目录中生成了两个文件

其中SUMMARY.md是目录文档，我们使用notepad++或者记事本打开

此时，gitbook默认生成了一个标题叫Introduction的目录，对应的文档是README.md。在这里为了达到演示效果，新建一个文档

取名字叫content_01，然后使用记事本或notepad++打开编辑

同时编辑SUMMARY.md文件，添加如下内容

保存后，在命令提示符中输入

gitbook serve

在浏览器中打开此地址，即可看到生成的文档

选择“第一章”标题，查看一下生成的文档内容

是不是很到玩呢？哈哈，如果有的小伙伴问二级目录该怎么生成呢？很简单，只需要在目录前加一个空格即可

运行效果如下：

最后，如果想生成html，放在服务器上运行，怎么办？

gitbook build

此时，项目目录下会生成_book文件夹，此文件夹中就是我们想要的html文件

打开_book文件夹

当然，此时若直接打开index.html文件是无法直接运行的，我们需要给它一个web环境，可以在本地启动一个tomcat也可以启动一个IIS，直接将_book文件夹中的内容丢进去即可