gitbook 是一款文档编写利器,可以方便地 markdown 输出成美观优雅的 html ,gitbook serve 启动服务器后,原来相貌平平的 markdown 丑小鸭摇身一变就成了倾国倾城的 html 绝色佳人 ，总结文档的一个很好的选择。
gitbook环境搭建-windows篇：
gitbook是基于node.js的一个应用 https://github.com/GitbookIO/gitbook
但官网于2018年年底就放弃维护了.若下载最新版本的node js进行构建则会安装失败,用旧版本的node js即可解决
nodejs旧版总汇:https://nodejs.org/zh-cn/download/releases/
建议使用https://nodejs.org/download/release/v8.11.3/
window包下载地址:https://nodejs.org/download/release/v8.11.3/node-v8.11.3-x64.msi
下载后点击安装即可 然后进入该项目根目录：
npm install -g gitbook-cli
gitbook --version
gitbook install
gitbook build
gitbook serve踩坑记录：
1. PluginError: Error with plugin "include-html": Cannot find module 'q'
解决办法：npm install incluede-html
2.Failed to load plugin html: Cannot find module 'eslint-plugin-html'
解决办法：npm install –save-dev eslint-plugin-html
3. 其他踩坑总结链接：
https://zhuanlan.zhihu.com/p/123827414
https://zhuanlan.zhihu.com/p/123870902
https://zhuanlan.zhihu.com/p/125577482
4. 在本地修改gitbook，服务会重启失败，热更不了？
找了些文章，没有好的解决办法，如果启动服务器后立即删除 _book 目录,那么之后再怎么修改本地文件都能顺利重启。有意思的爬坑文章：https://juejin.im/post/6844903840332939277