Mintlify vs Livemark
更新于 2026年11月12日
Mintlify 是一个商业文档平台。内容在 Git 仓库中以 MDX 编写；Mintlify 负责托管渲染后的站点、搜索和数据分析。按编辑者数量计费，并为开源项目提供免费套餐。
概览
| 维度 | Livemark | Mintlify |
|---|---|---|
| 语言 / 运行时 | TypeScript / Node 24+ | 使用 MDX 编写；运行时是 Mintlify 的托管平台（未公开） |
| UI 框架 | React 19 | React（据 Mintlify 文档） |
| 构建工具 | Vite + TanStack Start | Mintlify CLI（预览）+ 托管构建 |
| 内容格式 | Markdown + MDX | Markdown + MDX |
| 许可证 | MIT，自托管 | 专有，仅托管 |
| 输出模式 | 预渲染静态站点（支持 SSR） | 托管在 Mintlify 基础设施上 |
架构
Livemark 是一个 Node CLI，它构建出的静态站点可以托管在任何地方。源码和输出都归你所有。
Mintlify 是托管式 SaaS。你把 MDX 和 mint.json 配置提交到 Git 仓库；每次 push 后 Mintlify 拉取代码、执行构建，并通过 <your-subdomain>.mintlify.app 或自定义域名提供服务。构建流水线和运行时都由平台管理，用户无法自行安装。
Livemark 对内容布局没有限制：它按 glob 扫描（livemark.config.ts 中的 include/exclude），每篇文章的 URL 默认取决于文件在其 include glob 下的位置，也可以由前置元数据 frontmatter 中的 path: 字段指定。不强制要求 docs/ 文件夹——项目可以从 README.md、docs/、blog/、各个包的 README 或其他任何地方获取文章。Mintlify 要求文件树与 mint.json 中的 navigation 块一致；路由对应已配置内容根目录下的文件路径。
内容能力
两者都支持带 frontmatter 和嵌入组件的 Markdown + MDX。
Mintlify 内置一组固定的组件（<Card>、<Accordion>、<Tabs>、<Steps>……），供作者在 MDX 中组合使用。你不需要为文档 UI 编写自己的 React 组件——直接使用 Mintlify 提供的基础组件即可。
Livemark 的指令（:::card、:::tab、:::steps）通过 Livemark 的组件层生成同类 UI，你可以通过 .livemark/components/ 覆盖这些组件。
Mintlify 的 mint.json 在一个声明式文件中配置导航、品牌和集成。Livemark 用 livemark.config.ts 承担相同的角色，并通过 .livemark/ 覆盖层实现逐文件定制。
功能对比
| 能力 | Livemark | Mintlify |
|---|---|---|
| 版本管理 | 部分支持（栏目或按分支部署） | 是（内置） |
| 国际化（i18n） | 是（内置） | 是（内置） |
| 搜索 | 是（Orama，客户端） | 是（内置，AI 驱动） |
| AI 聊天 / 智能体 | 否 | 是（内置） |
| 数据分析 | 否（自行接入） | 是（内置仪表盘） |
| OpenAPI 渲染 | 否 | 是（内置） |
| 博客 | 是（内置栏目类型） | 是（更新日志 / 新闻页面） |
| 站点地图 | 是 | 是 |
| RSS | 是（每个博客栏目） | 是（更新日志订阅源） |
| 主题 | 通过 .livemark/ 覆盖组件 | 通过 mint.json 配置主题 |
| 自定义路由 | .livemark/routes/ | 否（仅内容） |
| 自托管 | 是 | 否 |
输出与部署
Livemark 构建出一个静态目录，可部署到任何托管平台——参见部署。
Mintlify 的部署由 Mintlify 负责。你无需自行构建或托管输出；平台通过其 CDN 提供渲染后的站点，并负责 TLS、域名和预览。离开 Mintlify 意味着要重写内容或将其迁移到别处。
另请参阅
用 ❤ 和 Livemark 构建