重要发布
- 重大增强:在 404 页面提供 AI 推荐页面,当用户访问死链 → AI 代理读取路径 → 推荐语义相似的页面
- 重大发布:文档助手的网页搜索现可包含外部来源
 注意:请联系我们为你的站点启用此功能。
文档助手与 MCP
- 修复由于时间窗口未正确滑动导致文档助手被错误限流的问题
- 修复文档助手工具调用中对空 text块的处理
- 修复 MCP 服务器名称与工具调用拼接后有时超过 MCP 客户端强制的 60 字符长度的问题
- 修复文档助手菜单高度远超视口并无限滚动的问题
- 修复仪表盘中文档助手开销数值可能显示超过两位小数的问题
网页编辑器与部署
- 增强编辑器安全性:仅具有已连接 Git 托管仓库 write permissions的用户才能进行更改
- 修复分支名称包含 =时无法进行预览部署的问题
- 修复过长的分支名称在创建预览部署的模态框中溢出的问题
- 体验优化:在注册邀请中,email 查询参数将预填输入框
- 修复通过上下文菜单复制页面在 Safari 上无效的问题
API交互测试台与导航
- 多个 API交互测试台 响应码在聚焦时现显示在受控且样式化的选择菜单中,而非系统默认选择菜单
- 现在你可以在 docs.json的导航分组上使用expanded字段以默认展开这些分组
SEO 与界面
- 修复 favicon 未在搜索引擎中显示的问题,现在为各站点从与文档站点相同的 URL 提供服务
- 修复 YouTube 嵌入在加载时闪烁的问题
- 修复将反馈菜单展开以包含文字回复时导致目录布局偏移的问题
- 修复在 Maple 主题中关闭通知横幅后文本会溢出到顶部栏上方的问题
- 为 Maple 与 Willow 主题在侧边栏新增登录/登出按钮,便于快速访问
分析与导出
- 修复文档助手分析视图与导出的可靠性问题
- 文档助手分析导出现在后台执行并通过邮件发送,体验更可靠
重要发布:反馈收集能力增强
- 重大改进:读者在选择点赞/点踩后,现在可以提供更细化的反馈,包括选项和文字评论。你还可以对代码块收集反馈,并在仪表盘的分析中查看所有反馈。
 注意:请联系我们为你的网站开启此功能。
导航与易用性改进
- 易用性提升:忽略结尾斜杠和双斜杠,这样你无需在文档配置文件中精确处理它们
- 你现在可以在 h1-6HTML 标签上添加noAnchor属性,避免生成锚点链接
- Palm 主题现在在左下角提供一个浮动语言选择器,类似 Stripe 的做法
- 在文档配置文件中新增字段 drilldown,可控制在展开导航分组时,是否自动跳转到该分组的第一页
- 易用性提升:使嵌套有序列表在十进制/罗马数字与字母样式之间交替显示
缺陷修复与可靠性
- 修复了当页面存在 JS 组件时,滚动位置锚点链接无法正确工作的问题
- 修复了由于缺少 x-robots-tag noindex头导致 Google 索引原始*.md文件的问题
- 修复了受保护文档上的 OAuth 问题:成功完成流程后无法重定向回起始页面
- 修复了认证保护文档的预览中无法看到完整导航栏的问题
- 改进了使用我们新图片 CDN 处理 SVG 的相关问题
组件与样式增强
- 为 SidebarNavGroupDivider新增可用于自定义样式的 CSS 选择器
- 为在 MDX 中定义且带有安全配置的 API 页面新增回归测试,进一步提升稳定性
性能优化
- 将 KaTeX 的 CSS 从 cdnjs 迁移到我们在 CloudFront 上的自有 CDN,以降低延迟并提升性能
图像处理改进
- 重大改进:即使未指定宽度和高度属性,图像默认也不会引起布局偏移——自动尺寸可防止页面加载时内容跳动
- 仓库中的所有静态文件(PDF、TXT、XML 等)在部署时现已自动上传并提供服务,实现完整的资产覆盖
网页编辑器与部署增强
- 修复了网页编辑器中的分支创建流程,现在会正确跳转并停留在新建分支上
- 增强了合并冲突对话框,支持正确的退出,无需再刷新页面来关闭冲突
- 优化了更新流程性能:在部分更新时仅对变更页面进行缓存失效,缩短部署时间
认证与导航改进
- 新增对自定义子目录的认证支持;如果在 https://yourdomain.com/docs提供文档,认证现在可无缝工作
- 修复了仅配置一个链接时仍错误显示侧边栏的问题
- 全面改进移动端导航:按钮居中并具备合理的外边距/内边距,优化下拉菜单间距,移除空区块的不必要分隔线和外边距,并修复 Maple 主题的间距/内边距问题
组件与样式修复
- 解决了将 <h1-6>标签错误转换为 Heading 组件并破坏自定义样式的问题
- 在仪表盘中新增一键切换文档助手配置的开关,便于管理
技术改进与可靠性
- 增强了更新流程的日志系统,加速调试与问题定位
- 通过由逐个文件获取改为仓库克隆,修复了拥有 10+ OpenAPI规范/AsyncAPI规范 的客户在 GitHub 上遭遇的限流问题
- 提升了文档助手的可靠性:增加后备 LLM 支持、强化限流错误处理,并改进搜索工具的稳健性
性能与构建优化
- 在未缓存的 NextJS 无服务器环境中,MDX 转译现改为在部署时执行,而非在每次页面加载时执行,从而缩短未缓存页面的首字节时间(TTFB)。
- 基于内容的哈希在 MDX 未变更时避免重复转译,使页面量较大的客户更新耗时减少约 50%(超过 5 分钟的部署大致能减半)
- 仪表盘中的预览部署加载更快了——我们在后端新增数据库索引并并行化查询
- 通过移除每个页面 rsc负载中的重复navigation数据,降低页面体积——在页面数量多或导航结构复杂时收益更明显
- 更积极的预取使页面更常达到即刻加载
API交互测试台与 OpenAPI规范 增强
- 将 OpenAPI 到 MCP 的转换迁移到后端,使托管的 MCP 服务器能够包含工具(更清晰的文档与配置选项即将推出)
- 为 API交互测试台 增加了 Ruby 支持
- 新增功能:现在可仅通过 docs.json 指定 API 页面,无需创建新的 MDX 文件。
- 在基于 OpenAPI 规范的文档导航中支持webhook页面
- 通过在跳转至 Anthropic、OpenAI 或其他提供商时,从 Markdown 链接中移除锚点片段,优化了 AI 模型上下文
网页编辑器 改进
- 创建/重命名文件时,点击空白处即可保存更改,无需按 Enter 键
- 修复分支导航问题:当将 URL 改为特定分支时,会被重定向到上次活跃分支而非目标分支
- 对包含 /的分支标题进行正确的 URL 编码,防止导航异常
- 修复单体仓库仪表盘编辑器中的 Ctrl+K链接快捷键此前会在前面加上文档仓库路径并导致链接错误的问题
分析与 LLM 集成
- 支持自定义 llms.txt与llms-full.txt——将文件放在文档仓库根目录,即可通过/llms.txt和/llms-full.txt端点对 LLM 进行定制
- 添加了 Hightouch 分析集成
- 增强了上下文菜单的分析追踪(仪表盘视图即将上线)
- 为 llms.txt与llms-full.txt增加了端到端测试,确保正确提供
组件与样式增强
- h{1-4}标签支持自定义类名,以应用自定义标题样式
- 修复了自定义页面模式下,h{1-4}标签渲染为带标签条的Heading组件的问题
- 为面包屑添加 CSS 选择器,便于自定义 CSS 定位
- 通过分析尺寸,在 56px 高度下保持比例,修复了被拉伸的 open-graph 图片
- 在启用时,将上下文菜单中的 VSCode更正为VS Code
- 修复了自定义组件内的标题会与语义标题一同出现在目录中的问题
Bug 修复与可靠性
- 通过清理导致生成问题的字符,修复了某些页面标题的 PDF 渲染问题
- 解决了遇到空的 OpenAPI JSON 文件时 CLI 报错 Cannot convert undefined or null to object
- 修复了自定义 docs.jsonopen-graph 元标签被生成标签覆盖的问题
- 通过对 RSS 链接使用 origin + pathname,修复了落在锚点链接时 RSS 订阅按钮点击失效的问题
- 通过移除 sourcemap 提升了 CLI 下载速度
技术改进
- 在 CI 流水线中加入可视化测试,更早发现回归
- 增强错误处理与调试能力
- 为新功能与边界情况提供了更全面的测试覆盖
认证改进
- 组级公共访问:通过 docs.json将整个页面组设为公开,这样就无需在每个页面上添加public: true(了解更多)
- 在 OAuth 配置中支持 logoutURL,用于删除上游 cookies 并完成登出
- 当 OAuth 出错时,用户会被重定向到你指定的 logoutURL以重新开始认证流程
- 修复了在 OAuth/JWT 流程回调前短暂出现 500 错误的问题
- 在 OAuth/JWT 认证配置中自动去除 URL 中的 https://,以防止配置错误
API交互测试台增强
- 新增 Search API 端点,可基于你的文档构建智能体和 MCP 服务器
- 现在会按其指定路径提供 openapi和asyncapi文件(例如https://mydocsurl.extension/{openapi-or-file-name}.json)
- 你现在可以在 OpenAPI 规范文件中使用 x-mint字段 来覆盖生成字段、自定义前言内容,或更改代码示例中的端点 URL
- 在 OpenAPI 配置中,x-mcp现为x-mint.mcp,用于控制哪些路由以 MCP 工具的形式暴露
文档助手更新
- 修复了当新消息流入时,旧消息的操作菜单(包含复制、点赞等选项)会消失的问题
- 修复了上周托管 MCP 服务器发布后,嵌套的 /mcp/...页面可访问性问题
性能与可靠性
- 文档仓库中的所有图片和视频资源现在都会在你的域名下按正确路径提供。例如,如果仓库中有 /assets/marketing/my-logo.png,可通过https://mydocsurl.extension/assets/marketing/my-logo.png访问。
- Mintlify 控制台登录页的邮箱输入框现在会自动聚焦,便于立即输入(体验优化)
- 在 Redis 中同时存储自定义域名和子域名,以提升导航加载性能(约 50ms 延迟降低)
- 为 PDF 导出添加了重试逻辑,以提高可靠性
- 修复了在接受或关闭后 Cookie 同意弹窗仍会再次出现的问题——现在首次选择会被尊重
- 通过在 navigator.write中指定 MIMEtype,修复了在 Safari 上复制页面到剪贴板的问题
技术改进
- 面向 Windows 和 pnpm 的 CLI 修复,并新增 CI 测试以防回归
- 改进了错误日志输出——为工程团队调试带来体验升级
- 当缺少 contentDirectory文件时,修复了断链 CI 动作的一些小问题
- 修复了上周为受认证保护的预览所做修复引入的回归问题,导致导航 UI 中未能正确设置活动选项卡
- 修复了主题的浅色背景未应用于活动选项卡图标的问题
- 修复了在控制台更改认证类型后会更新但又切回先前保存类型的问题——现在新选择在保存后会保持
- 为使用自定义 UI 库的企业客户带来内部开发体验改进——我们现在更容易在更短时间内纳入你的组件并满足需求
认证改进
- 本地开发中的认证流程优化,加速相关功能开发与缺陷修复
- 现已支持为受认证保护的网站提供预览部署
- 修复重定向行为,确保认证后返回用户的原始页面
- 修复完整认证的登出按钮显示问题(此前仅适用于部分认证)
API交互测试台增强
- 修复 API交互测试台中 multipart/form-data文件上传功能
- 修复锚点链接行为,使点击后仅更新 URL 而不会滚动至页面顶部
- 修复嵌套选项卡中的锚点链接问题
文档助手更新
- 新增文档助手 API,可将其集成到你的产品中,兼容 AI SDK
- 在聊天回复中新增复制按钮
- 修复在文档助手中重试消息的问题
- 优化默认助手提示词,使其默认更为简洁
性能与可靠性
- 通过在输入时中止防抖请求,让搜索更灵敏且更准确
- 为新的 CDN 预配资源——预计图片与页面加载时间将很快得到改善
- 修复渲染复杂 Mermaid 图(如 GANTT 图)的缺陷
- 修复 Windows 上的 CLI 缺陷以提升稳定性,并新增测试防止回归
技术改进
- 在 Next.js 应用中加入 OpenTelemetry 追踪,以改善用户的首字节时间
- 从 Octokit 迁移到 GitHub API Client,降低网页编辑器中的延迟
- 修复 OpenGraph 的重复 meta 标签
- 将 MongoDB 从 6 升级到 7,提升性能并引入新特性
Slack 应用
- 零摩擦访问:Bot 可响应私信、@提及,以及你 #ask-ai频道中的任何问题
- 一键安装:可在数秒内直接从你的 Mintlify 仪表盘安装
- 上下文答案:搜索你的全站文档,提供相关且准确的回答
- 降低支持干扰:将日常问题转化为即时的自助式答案
托管 MCP 服务器
通过 Mintlify 直接部署托管的模型上下文协议(MCP)服务器,以集成 Claude、Cursor 等 AI 工具。更多信息见我们的 MCP 指南。通过上下文菜单,帮助用户从文档任意页面快速将你的 MCP 服务器连接到 Cursor 或 VS Code。详见 上下文菜单。代码块改进
- 改进语法高亮
- 新增更多自定义选项,包括专注模式、可展开代码块、深浅色模式自适应、语言下拉菜单、行号和图标
API交互测试台稳定性更新
- 支持搜索以查找端点
- 用标签标注已弃用的端点
- 从导航中隐藏自动生成的 API 页面
- 支持上传 multipart 或表单数据文件
mint update
现在可以使用 mint update 来更新你的命令行工具。网页编辑器 3.0

- 使用 ⌘ + P 快捷键搜索文件名
- 页面加载速度提升 10 倍
- 搜索分支时加载更快
- 新增“页面选项”页签,可配置布局、标题和用于 SEO 的元数据
- 选中文本时显示浮动工具栏
- 修复变更日志组件的顶部外边距
- 提升右键交互的稳定性
- 点击发布后将停留在当前页面,而不会跳转到空白状态
- 统一文件图标的配色
- 连续多次切换新分支后的稳定性改进
- 移除 Diff 模式
- 从下拉菜单新建文件夹的行为更一致
- 修复尝试取消选择时引用块会新增引用块的问题
AI 翻译(测试版)

导出文档为 PDF(测试版)
将全部文档、某个子目录或单个页面导出为 PDF。支持 React Hooks
为文档带来交互能力。所有标准 React Hooks 将在你的 MDX 文件中自动可用。了解更多。MCP 服务器生成器

改进
- 为变更日志更新添加标签,便于终端用户筛选
- AI 聊天支持 Sonnet‑3.7。可通过控制台配置首选模型
- 可在控制台设置中直接更改部署名称
Bug 修复
- 修复 OG 图片
- 修复无容器锚点的图标样式不一致
- 改进控制台边框在移动/平板/桌面端的响应式样式细节
- 在 API交互测试台 的简洁模式下也显示代码示例
- 网页编辑器支持使用 “command + k” 快捷键搜索
- 提示框内的代码块可展开以填满提示框区域宽度
新配置架构 docs.json

docs.json 架构以取代 mint.json,以更好地支持多层版本管理、提升可视化可读性,并统一术语。了解变更详情,请查看我们的博客。按以下步骤从 mint.json 升级到 docs.json:- 确保你的 CLI 为最新版本
- 在文档仓库中运行
- 删除旧的 mint.json文件并推送变更
CI 检查
自动对文档进行 lint,以发现失效链接、拼写与语法问题,或使用你自定义的 Vale 配置来约束写作风格。详见我们的文档。面向 LLM 的 .md 支持
现在所有文档页面都会自动提供为纯 Markdown 文件——只需在 URL 末尾追加.md。这让 LLM 更容易摄取你的文档单页内容。更多主题

- Maple
- Palm
- Willow
其他改进
November 2024
AI 写作

GitLab 集成升级
我们增强了与 GitLab 的同步支持,例如启用自动更新和预览部署。请查看我们的GitLab 文档开始使用。网页编辑器

/llms.txt 支持

本地化
你现在可以为文档提供本地化,工作方式类似于版本管理。为某个版本添加locale 后,Mintlify 中的固定内容(如“这页对你有帮助吗?”)也会匹配对应语言。质量改进
- 基于用户当前阅读的版本返回聊天与搜索结果
- 除了 JWT 或共享会话令牌外,还可通过 OAuth 进行用户认证。
October 2024
变更日志
我们推出了全新的更新组件,让你更轻松地向用户展示和发布更新(如本条)。
代码行高亮
你现在可以在文档中高亮代码行:在语言标识后添加特殊注释,突出重要内容。使用花括号{},并用逗号分隔指定的行号或区间范围。Line Highlighting Example
浅色模式代码块
代码块现在支持浅色模式变体,可通过在你的docs.json 中添加以下配置启用:高级页脚

基于当前用户筛选搜索
启用个性化后,搜索结果会根据当前登录用户进行筛选,仅展示与其相关的内容。AI 聊天自定义提示词
你现在可以自定义 AI 聊天的提示词。如需开启,请联系support。控制台改进
- 新增在控制台设置中将自定义域名直接配置为 /docs 的能力。
- 合并登录与注册页面,降低操作阻力与困惑。
- 实现发现式登录流程,支持属于多个组织的用户在其间切换。
- 新增使用 Google OAuth 登录。
- 新增在控制台设置中添加新部署的能力。
错误修复
- 导航中现在可使用前导斜杠。
- 现在可在网页编辑器中编辑 CSS 和 JS 文件。
- 修复了启用后 suggestEdit仍不显示的问题。
- 修复了搜索与聊天的键盘导航,现在可用上下方向键浏览结果。
- 不允许搜索引擎抓取需用户认证的页面。
- 当组织被删除时会重新验证缓存。
- 现使用 Scalar OpenAPI 解析器解析 OpenAPI 定义,从而提升性能、修复解析问题,并提供更清晰的错误信息。
- 由 OpenAPI 定义自动生成的 API 参考页面现在支持顶层描述。
- 新增对图标的内联样式支持。
- 修复了文档中自定义 CSS 的“闪现”问题。
- 在与链接同时出现时,正确展示行内代码样式。
- 在浏览器中点击后退按钮时保持滚动位置。
September 2024
自定义字体

卡片组件中的图片
在卡片上添加img 属性,可在卡片顶部显示图片。了解更多内容请见此处。更新速度优化

SEO 改进

控制台改进
- 在控制台中完成 App Router 迁移。
- 控制台现已提供搜索分析。
- 控制台新增删除组织功能。
- 上线了 GitLab 连接 UI。
- 修复了错误的分析数据。
- 现在可直接通过控制台购买附加组件。
Bug 修复
- 修复了在自定义模式且侧边栏布局为 sidenav时,顶栏不会拉伸至全屏宽度的问题。
- 修复了 AI 小部件的相对定位问题。
更多
- API 页面疑难排查:API 页面可能较为复杂,我们整理了常见问题,帮助你快速解决—— 阅读文档
August 2024
OpenAPI 参考页面
- 由 OpenAPI 定义的复杂且递归的端点现在体积减少 98%。
- 我们现在会在 OpenAPI 页面中展示 additionalProperties。
API 交互测试台中的文件上传
默认情况下,API 交互测试台的请求由 Mintlify 代理。现在你可以使用disableProxy 禁用此行为,以支持文件上传等请求类型。移动端 SEO 改进
我们已修复文档的移动端布局,使其更符合 SEO——包括为元素添加合适的 aria 标签。支持表单
我们在 Mintlify 控制台中新增了更详细的支持表单。你现在可以提交表单与我们联系。Bug 修复
- 修复了 Segment 集成功能的一个错误。
- 与编辑器交互时,我们现在会针对 GitHub 权限抛出更细化的错误信息。
- 修复了在使用直接链接时导航无法正确展开的问题。
July 2024
June 2024
发布周亮点
- 主题:使用预设主题自定义样式。只需将 Quill、Prism 或 Venus 主题添加到你的 docs.json文件中,即可更新文档样式。
- 搜索 V2:可直接检索 OpenAPI 端点的描述和标题以跳转到 API 参考页面,从搜索结果中移除隐藏页面,并使用我们升级后的搜索栏界面。
- 网页编辑器分支:无需 IDE,即可在网页编辑器中创建分支。
- 用户个性化:使用 Shared Session 或 JWT 进行用户认证,以展示个性化内容,例如预填 API 密钥或为特定客户显示定制内容。
- OpenAPI 自动化升级:为自动填充 API交互测试台 页面,你可以在 docs.json的 tabs 或 anchors 数组中的对象添加openapi字段。
April 2024
February 2024
质量改进
- 仪表盘升级:查看更新日志以了解变更及更新状态,在 Mintlify 项目之间切换以管理部署
- 选项卡式版本管理现已完整支持
- 现已支持通配符重定向
- CLI 错误检测:本地开发出现解析问题时,我们会显示无效 frontmatter 的位置
January 2024
发布周亮点
- 预览部署:当你创建 pull request 时,我们会生成一个唯一链接,展示你的文档在生产环境中的实时预览。你可以将该链接分享给队友。
- 代码片段 V2:现在支持可完全复用的组件和变量,用于代码片段。
- 开源 MDX 引擎:我们开放了两个 API——getCompiledMdx 和 MDXComponent——以便访问 Mintlify 的 Markdown 与代码语法高亮。欢迎为该项目贡献代码。
- AI 聊天洞察:在仪表盘中按日期分段聊天历史、提升 AI Chat 配额,并查看特定查询的出现频率。

