MkDocs 的替代品
12 个可以替代 MkDocs 的工具,8 个可完全替代、4 个部分替代,1 个在国内不能直接访问、归在最后。费用、登录、平台与可访问性都是本站实测或从官网核对的。
对比
| 条目 | 费用 | 登录 | 国内访问 | 一句 |
|---|---|---|---|---|
| 免费 | 不用登录 | 可以 | Markdown 写文档生成带侧边栏和搜索的站点,构建更快,配置思路相近 | |
| 免费 | — | 可以 | 同为 Markdown 静态站生成器,与 GitHub Pages 打通可免费部署,但配置用 Liquid 模板而非单个 | |
| 免费 | 不用登录 | 可以 | 同为 Markdown 静态文档站生成器,内置版本管理和多语言,换过去功能更全 | |
| 免费 | — | 可以 | Markdown 为中心的静态站点生成器,可嵌 Vue 组件,适合文档站 | |
| 免费 | 不用登录 | 可以 | 同样把 Markdown 渲染成静态 HTML,Go 单二进制构建更快,但配置分散在 config 与模板中,主题生态不 | |
| 免费 | 不用登录 | 可以 | 同样开源生成静态站,可混用多种模板语言,但需自己搭模板,没有 MkDocs 那样开箱即用的文档主题。 | |
| 免费 | — | 可以 | 同为文档静态站生成器,reStructuredText 为主,主题和扩展生态成熟 | |
| — | — | 可以 | 同为 Python 静态站生成器,Markdown 直接出 HTML,但配置和主题偏博客,文档站体验不如 MkDocs | |
| 免费 | — | 可以 | 替代写作与预览这一块:在线左右分栏即时渲染,文档存自己仓库,但没有静态站生成和部署流程。 | |
| 免费 | — | 可以 | 替代文档发布这一块:能把 Notebook 和 Markdown 连代码结果一起出站,但构建更重,纯文档项目用不上。 | |
| 有免费版 | 要登录 | 可以 | 替代写作与发布这一块:在线编辑、同步 Git 仓库,但站点托管在平台而非自建静态文件 | |
| 免费 | 不用登录 | 不可以 | 替代 Markdown 写作这一块:改用 AsciiDoc 语法出 HTML5,文档结构更强,但要重学语法且无内置预览服 |
按需求挑
免费的 MkDocs 替代品11 个
VitePress、Jekyll、Docusaurus、VuePress、Hugo、Eleventy、Sphinx、极客编辑器、Jupyter Book、GitBook(有免费版)、Asciidoctor