Mintlify 是一款 AI 原生的文档自动化工具，支持通过 CLI 命令快速搭建文档站点。环境配置（Node.js）、Skill 安装与接入、使用/mintlify 命令生成文档、本地预览以及基于 openapi.json 生成接口文档的完整流程。通过 Mintlify，开发者可实现文档的版本控制、多语言翻译及语义检索，大幅提升技术文档编写与维护效率。
Mintlify 是一款 AI 原生的文档自动化工具，核心优势在于对 GitHub 的天然适配性，以及简约、清晰、符合程序员审美的页面风格。不同于传统文档工具的繁琐配置，Mintlify 主打'轻量化实操、AI 原生赋能'，支持'文档即代码'（Docs-as-Code）模式，能与 Git、GitHub 等版本控制工具无缝衔接。
Mintlify 的安装和使用依赖 Node.js 环境，官方推荐使用 Node.js 20.0 及以上版本。
检查本机 Node.js 版本：
node -v。Node.js 安装完成后会自动安装 npm，后续使用的 npx 命令会依赖 npm。
Skill 是一段经过优化和沉淀的提示词脚本。Mintlify 的 Skill 包含了官方文档的编写规范、组件使用方法、最佳实践等核心信息。通过调用 Skill，能让 AI 按照 Mintlify 的标准生成文档，大幅提高生成结果的准确性和规范性。
此外，Skill 还支持自定义修改。熟悉规范后，可根据项目需求修改 Skill 中的提示词，实现个性化的文档生成。
Mintlify 官方推荐通过 CLI 命令将文档接入常用的 AI 工具（如 Cursor、Claude）。核心是安装 Mintlify-Skill。
再次打开终端，输入 node -v 和 npm -v，确认 Node.js 和 npm 已正常安装。
不需要手动下载文件，直接通过 npx 命令完成安装：
npx skills add https://mintlify.com/docs
npx：执行 npm 包中的可执行文件。skills add：添加新 Skill 的核心命令。https://mintlify.com/docs：Mintlify 官方文档入口 URL。终端输出'Successfully added skill: mintlify'时，说明安装成功。此时在 AI 工具中输入自然语言指令（如'帮我生成一个 Mintlify 的 Tabs 组件使用文档'），AI 即可基于官方规范生成内容。
若已搭建自己的文档站，可在根路径下确保存在 llms.txt 和 skill.md 两个文件，然后执行：
npx skills add https://你的文档域名
AI 工具会自动读取文件生成自定义 Skill。
装好 Mintlify-Skill 后，可通过 AI 工具使用 /mintlify 命令 + 自然语言描述，快速生成符合规范的文档。
使用 Skill 相当于给 AI 提供了'标准答案'，AI 会严格按照定义的规范、模板生成文档，格式规范且无需手动修改。
/mintlify，按下空格，输入自然语言描述。
例如：
/mintlify 生成 Mintlify Accordions 组件的使用文档，包含组件介绍、参数说明、示例代码、注意事项
熟悉规范后，可手动修改 Skill 提示词。以 Cursor 为例，保存目录为 .cursor/skills/mintlify，找到 skill.md 文件进行修改。注意不要破坏原有规范结构。
生成文档内容后，需启动 Mintlify 服务进行预览。
npx mintlify dev
当终端输出'Local development server running at: http://localhost:3000'时，服务启动成功。
http://localhost:3000。Mintlify 支持基于 openapi.json 文件，一键生成专业的 OpenAPI 接口文档。
主流 Web 开发框架（如 Spring Boot、FastAPI）都支持自动生成 openapi.json 文件。
FastAPI 原生支持 OpenAPI 规范。启动应用后，访问 http://localhost:8000/openapi.json 即可获取文件。
示例代码：
from fastapi import FastAPI
app = FastAPI(openapi_url="/openapi.json")
需添加 springdoc-openapi 依赖。在 application.yml 中配置访问路径，启动后访问对应地址获取 JSON 文件。
openapi.json 文件放到 Mintlify 文档目录根路径下。openapi-docs.mdx），添加以下代码引入 OpenAPI 组件：import { OpenAPI } from "@mintlify/components";
<OpenAPI specUrl="/openapi.json" />
npx mintlify dev）。生成的 OpenAPI 接口文档具备美观简洁、可交互（支持测试）、结构清晰、信息完整及自动更新等特点。
Mintlify 还支持以下高级操作：
Mintlify 作为一款 AI 原生的文档自动化工具，以其简约的风格、便捷的操作、强大的功能，成为开发者的得力助手。通过本文的实操教程，可以快速掌握 Mintlify 的核心用法，包括环境搭建、Skill 安装、文档生成、预览及接口文档生成，大幅提升技术文档编写和维护的效率。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online