GitBook教程指南

工欲善其事必先利其器

前言

在V2EX上看到有讨论markdown工具的帖子，许多人推荐了Typora，简约美观。而我一直比较喜欢Gitbook。Gitbook有几个优点：

• 使用Git，方便存储、回退、协作等
• 轻松导出多种格式，如html、pdf等
• 有书籍列表，方便管理
• 有众多插件

安装

• 安装Node.js
• 安装gitbook

npm install -g gitbook-cli

检查是否安装成功 gitbook -V

• 安装gitbook editor
  进入官网下载安装，Mac也可以直接使用命令brew cask install gitbook-editor。

创建书籍

安装完环境以后，先试着创建一本书。先进入准备写书的目录，然后输入命令。

$ gitbook init
warn: no summary file in this book
info: create README.md
info: create SUMMARY.md
info: initialization is finished

这样就在当前目录创建了一本书。SUMMARY.md是书籍目录，README.md是书籍简介。 也可以指定目录创建书籍，如下。