基本使用

编辑器

markdown的编辑器选择很多,可以根据自己的习惯选择

  1. 文本工具,例如:sublime Text, Notepad++
  2. IDE,例如:Intellij IDEA、WebStorm都提供了markdown插件
  3. markdown编辑器,如MarkdownPad,MarkPad,Mou,简书,gitbook eidtor

gitbook

书籍目录结构创建完成以后,就可以使用 gitbook serve 来编译和预览书籍了:

$gitbook serve
Live reload server started on port: 35729
Press CTRL+C to quit ...

info: loading book configuration....OK
info: load plugin gitbook-plugin-splitter ....OK
info: load plugin gitbook-plugin-fancybox ....OK
info: load plugin gitbook-plugin-mermaid ....OK
info: load plugin gitbook-plugin-highlight ....OK
info: load plugin gitbook-plugin-search ....OK
info: load plugin gitbook-plugin-sharing ....OK
info: load plugin gitbook-plugin-fontsettings ....OK
info: load plugin gitbook-plugin-livereload ....OK
info: >> 8 plugins loaded
info: start generation with website generator
info: clean website generator
info: OK
info: generation is finished

Starting server ...
Serving book on http://localhost:4000

gitbook serve 命令实际上会首先调用 gitbook build 编译书籍,完成以后会打开一个 web 服务器,监听在本地的 4000 端口。

接下来可以用浏览器打开 http://localhost:4000 查看书籍的效果