我心目中的写作套件，是这样的：
- 不需要排版，只需要遵从约定，写完就真的完了；
- 不需要花哨的功能，提笔就能写，想写就写；
- 写点儿就提交，文本型，支持版本控制系统；
- 多人协作，众人拾柴火焰高；
- 支持大型文档创作，比如1000000000000000+页；
特能写
我推荐这样的一套配置，免费好用极了：
gitbook+github+Typora，Windows和macOS都能用。
使用这套写作工具时有三个需要注意的地方，其中两个是在锚点部分，一个在插入图片部分：
- SUMMARY.md文件中写大纲（目录）时，连接锚点受html语法限制，不能带空格，如下图的maven锚点；
锚点不能带空格
- 在锚点对应的md文件中，使用span的id给出不带空格的锚点，span之内给出和summary对应（相等）的文字，这里可以随意使用空格；
使用span给出锚点
- 在Typora的编辑->图片工具->全局图像设置...菜单中勾选“优先使用相对路径”选项，不为文档设置图片根目录（确认编辑->图片工具->设置图片根目录...这个菜单选项是灰色的）；
图片使用相对路径
在上面设置下的图片代码类似于下图所示：
相对路径的图片
完成上述三个设置，完成写作的文档，在gitbook serve下就能正确编译显示。
正确的在线文档
至于如何使用github托管你的在线出版物，请参考https://pages.github.com/，也可以很方便的使用你自己的域名来访问你的出版物。
额外信息：如果你要将你的文章/书籍发布为pdf，则需要安装
calibre电子书管理器，这个安装包中包含了常用文档格式的转换工具，如pdf，epub，mobi等格式。Windows环境下载默认安装即可。
可在文章/书籍目录中执行如下命令生成pdf文件：
gitbook pdf
Kevin，2019年3月25日，北京。
网友评论