前言
文档工具的本质,其实都是将我们的文档内容标准化,在互联网环境上的文档,一般目前比较主流的是生成文档的 html 网页内容,而文档内容的作者都比较倾向于使用纯文本的 Markdown 进行书写,所以文档工具的核心内容主要就是将 Markdown 转换为一个 html 的网站内容。
目前市面上比较常见的工具有如下这些:
- Gitbook
- Docsify
- Docute
- Docusaurus
- Hexo
- Loppo
- Vuepress
- Vitepress
1. GitBook
首先不推荐 GitBook,原因是项目已经几年没有维护了,列在此处,仅做对比。
GitBook 的项目地址为 GitBook GitHub (opens new window),官网为 GitBook 官网 (opens new window)。
页面效果如下图:
2. Docsify
Docsify 的项目地址为 Docsify GitHub (opens new window),官网为 Docsify 官网 (opens new window)。
页面效果如下,有一个封面页和正文页:
Docsify 是一个文档网站生成器,它依赖于 node.js
,但不生成静态 html 文件,运行速度快,有很多插件。
环境配置难度低于编译型工具,同时有一个很炫酷的封面页,很好看,支持页内搜索和搜索插件,但它不会生成静态 html 文件,不利于搜索引擎收录,并且对于段落引用不支持,很多文档中的“解释”、“提示”项难以实现。
3. Docute
不推荐 Docute,原因同样是项目已不再维护。
Docute 项目地址为 Docute GitHub (opens new window),官网已不可访问。
4. Docusaurus
Docusaurus 项目地址为 Docusaurus GitHub (opens new window),官网为 Docusaurus 官网(opens new window)
页面效果如下,有一个封面页和正文页:
Docusaurus 可以帮助你在极短时间内搭建漂亮的文档网站。它依赖于 node.js
,同时前端框架为 React
,也支持 TypeScript
,能够开箱即用。
它有着漂亮的首页,支持不同的主题切换,支持页面搜索和搜索插件,支持连续的引用符号 <
生成好看的段落引用,还能为每页生成元数据,利于搜索引擎收录。
5. HEOX
Hexo 项目地址为 Hexo GitHub (opens new window),官网为 Hexo 官网 (opens new window)。
Hexo 是一个快速、简洁、高效的博客框架,基于 node.js
,由于本身只是框架,更多功能还需要主题插件支持,它更适合用作博客网站,而非文档网站。
6. Loppo
Loppo 项目地址为 Loppo GitHub (opens new window),示例网站为 Loppo 示例 (opens new window)。
页面效果如下:
7. VuePress
Vuepress 项目地址为 Vuepress GitHub (opens new window),官网为 Vuepress 官网 (opens new window)。
页面效果如下,有一个封面页和正文页:
Vuepress 依赖于 node.js
,有很多插件,会进行本地编译,为每个页面生成单独的 html 文件,有利于搜索引擎收录,支持页内搜索和搜索插件,支持段落引用扩展语法 :::tip
。
8. VitePress
由 Vite 和 Vue 驱动的静态站点生成器
页面效果如下,有一个封面页和正文页:
服务器即时启动,闪电般的热更新,还可以使用基于 Vite 生态的插件。