找一个好用的文档管理系统

之前因为工作的关系，用 HTML 记录文档，实在太 low 了。之后一直想找个好用的文档管理系统。要求其实也不太多，重要的就下面几点。

1. 文档格式为文本格式，方便进 git，做版本管理、review 及回溯；
2. 支持文本指令画 UML、流程图、架构图等等图解。图解同样需要进 git 管理；
3. 方便上传图片并插入到指定位置，能简单控制图片格式更好；
4. 支持 TOC（Table Of Contents，章节目录）；
5. 支持文档间跳转，类似 wiki；
6. 支持搜索并跳转，可以接受依赖于第三方搜索系统（如：ElasticSearch）的方案；

其中前四条可以用 markdown 类写作工具来解决，很多 markdown 写作工作都支持上述的功能，例如：、作业部落、sublime text等等。倒是第五条开始，支持得就比较少了，至于第六条，能做到的真是凤毛麟角。

gitbook 一直是我个人比较喜欢的一个工具：支持插件，扩展起来相对容易；基于 git + markdown，工具栈通用；支持章节管理和页面间跳转。虽然现在看起来没有比较好用的搜索插件，但自己开发一个也不是太难的事情。

于是最近试了试用 gitbook 来写一个简单的文档。目录中只有三个页面。写作的编辑器我选择了 gitbook 自带的 mac 版本 editor。

可惜，用之后我真的非常惋惜和遗憾。

也许是编辑器自己的问题，总是跳屏。在文档最末写着写着，整个屏幕自动翻页到文首，看不到光标。你接着输入，屏幕又跳回到文末，你还能看到你输入的内容——光标就没动过，动的只有屏幕。

一款跳屏的软件，还想对用户收取月 $7 的费用，真的也是醉了。

gitbook 是一个好的工具，同时它更是一个好的标准，借助 git + markdown 两个开放性的玩意，加上自己的 plugin 机制，给写作的人一个好的工具框架，支持全文本输入，把诸如
word 一类编辑器打成渣渣没问题。但如果不珍惜这么好的机遇，只是想着自己家赚钱，越做越小气，这么多年了，连最基本的问题都不能好好解决，除了『作死』，找不到更好的词送他们。

---

PS：我还会继续找这么一个好用的文档管理系统。gitbook 作为一种写作的方式或者说标准我也还会接着考虑。只是不会再用 gitbook 家自己的编辑器以及线上服务了。