该问题是怎么引起的？

文档对开源的重要性不言而喻，干巴巴的md，直接阅读不方便。

建议

如果选用gitbook，建议每个章节、子章节都增加SUMMARY.md文件；这样便于gitbook serve后结构化查看，也便于以后doc网站单独发布。
可参考一些国外项目对doc管理（多版本、更新迭代、反馈纠缠）。