一直在用 docsify 做为轻量级文档工具来使用,非常好用,这里推荐一下。

文档痛点

说到写文档,不得不说几个写文档的痛点:

  1. 支持 markdown
  2. 支持代码高亮
  3. 排版及样式好
  4. 易于分享及部署

简单点说就是,我只想安安静静的写个 markdown 文档,别整一些花里胡哨的东西。

为什么是 docsify

首先它完美解决了以上痛点,另外还有额外的特性

  • 无需构建,写完文档直接发布
  • 容易使用并且轻量 (~19kB gzipped)
  • 智能的全文搜索
  • 提供多套主题
  • 丰富的 API
  • 支持 Emoji
  • 兼容 IE10+

官网:https://docsify.js.org

以上都是花里胡哨的亮点,但是我并不关心,毕竟我只需要核心功能。

说说最大亮点:无需要构建,写完文档直接发布

想想,如果你写完一个 markdown 文件,git 提交部署到服务器上,然后别人在浏览器上直接刷新就可以看到你提交的文档,是不是很爽?更爽的是这个过程完全只需要一个静态服务就可以,完全不需要其它的东西。

快速开始

这里我个人提供了一个快速开始的模版:https://github.com/leo-yi/doc_template

使用方法非常简单,仅需要安装 docsify 然后一条命令驱动即可。

npm i docsify-cli -g
git clone git@github.com:leo-yi/doc_template.git
docsify serv doc_template/
tip: 配置使用的是默认配置。如果需要更多高级配置,请参考官方文档。

最后希望写文档将不再难 🤣

打赏不准超过你工资的一半!!!