产品更新

新版本与改进

​

10月24日

Improvements

​

洞察改进

• 优化了洞察页面，修复了“今天”和“昨天”的日期选择器
• 增强了反馈表，改进了搜索功能
• 为分类表新增加载状态

​

AI 助手改进

• 在控制台中新增助手位置配置
• 改进了助手回复，修复了上下文获取与工具消息的问题

​

API 操作台与 OpenAPI 增强

• 重构了 API 操作台的端点字段，采用新的架构图以提升性能
• 在助手侧边栏打开时，改进了操作台弹窗中的 API 示例展示
• 修复了紧邻 $refs 与 x- 属性的其他属性在 OpenAPI 解析中丢失的问题
• 修复了 API 操作台弹窗标题样式

​

Web 编辑器与部署增强

• 恢复了手动创建预览按钮，便于创建预览部署
• 在控制台中新增用于获取 branch 保护数据的提取器
• 在控制台中新增用于跟踪 PR 状态的提取器
• 改进了编辑器状态管理，使状态可在浏览器会话间持久化
• 修复了编辑器发布按钮的禁用状态
• 移除了编辑器中的代码块背景，使外观更简洁

​

性能与基础设施

• 在 Web 编辑器中实现了完整的 Git 同步，以更好地同步存储库
• 缓存了 MCP 响应以提升性能
• 改进了站点地图以规范化 /index 路径

​

Bug 修复与可靠性

• 修复了 API 操作台中认证预填值未正确填充的问题
• 修复了来自 seo.metatags 的自定义 meta 标签在客户端水合后仍能保留
• 使用 break-all 样式修复了页面标题文本溢出
• 移除了页面尺寸选项的全宽限制
• 修复了接受组织邀请的按钮尺寸
• 修复了在非 macOS 电脑上快捷键显示为不带加号的“Ctrl+I”的问题

​

10月17日

Improvements

​

助手与 AI 改进

• 升级了助手提示词，以获得更高准确度和更具上下文感知的回复
• 新增置信度评分，提升助手回复的决策质量
• 增强助手搜索，使用并行文档查询以更快返回结果
• 修复了助手消失的问题，并提升了其在小页面上的可见性

​

导航与 UI 增强

• 为导航组件添加了稳定的滚动条槽，确保布局一致
• 使“本页内容”部分可点击，可快速滚动到页面顶部
• 修复了所有主题中的助手栏定位
• 改进了助手栏以避免与内容重叠
• 修复了 Almond 主题下宽页面的最大宽度
• 调整了下拉箭头图标尺寸，使导航分组外观一致

​

API 操作台与 OpenAPI 改进

• 为新的 API 参考页面设计添加了功能开关支持
• 改进了 OpenAPI 架构图工具，正确处理组合关系
• 在操作数据中添加了端点类型，以改进 API 文档
• 修复了当枚举与表格以 Markdown 编写时 API 操作台的说明渲染
• 调整了 API 操作台中说明的渲染位置以获得更佳布局

​

Bug 修复与可靠性

• 修复了切换语言时会跳转到首页的问题，现保持在同一页面
• 修复了断链 CLI 在 CI/CD 集成中以代码 1 退出
• 修复了本地字体路径，现可正确添加前导斜杠
• 修复了 docs.json 中重定向处理忽略前导斜杠的问题
• 修复了规范 URL 对 /index 的剥离以提升 SEO
• 修复了折叠面板内有序列表的位置
• 修复了 <span> 标签样式，使其行为类似 <p> 标签
• 修复了列表中首个 <p> 标签的块级显示
• 修复了 OG 图片在索引页显示分区名称
• 修复了图标路径以包含 BASE_PATH，以支持相对路径
• 移除了助手背景模糊以提升性能

​

10月11日

Improvements

​

AI 助手与 Agent AI 功能

• 为 agent 新增 list_pull_requests 和 list_commits 工具，可一次性为某个日期范围内的 PR 或多个 PR 生成文档
• 将 agent 和助手升级至 Claude Sonnet 4.5
• 改进助手搜索，可并行查询文档，加快回复速度
• 修正会话长度统计，排除工具调用

​

洞察（Insights）改进

• 将 Analytics 重命名为 Insights
• 移除 Insights 的点击加载要求，可立即查看全部数据
• 通过服务端时间戳提升 Insights 数据准确性

​

Web 编辑器与控制台改进

• 去除编辑器中代码块背景，使外观更简洁
• 修复 branch 创建流程，正确跳转到新创建的 branch
• 新增部署历史分页
• 为预览部署表格新增游标分页
• 修复预览部署仅返回预览环境部署
• 优化控制台 UI/UX，改进间距、输入处理和布局
• 改进控制台助手聊天中的链接处理
• 修复 Firefox 中聊天助手的描边/轮廓显示问题

​

API 操作台增强

• 改进 API 操作台模态框的渲染
• 修复 API 操作台中可展开项与锚点链接不兼容的问题
• 新增在 API 操作台中合并示例与用户输入的 body 的支持
• 修复 API 操作台中视频响应的显示方式

​

错误修复与可靠性

• 修复 404 推荐页面中的重复基础路径与链接
• 自动填充 og:url 标签为合适的规范 URL
• 添加 canonical 标签以提升 SEO（搜索引擎优化）
• 修复代码块过度滚动问题
• 使搜索引擎忽略预览部署，以满足 SEO 需求
• 修复来源跟踪，改为使用 domain 而非完整 URL
• 修复图片总是变为 MDX 块级元素的问题（保持行内图片为行内）
• 移除原始 Markdown 页面中的注释，可使用 TODO 注释且不会泄露给用户
• 修复 read_external_files 的目录读取支持

​

组件与样式

• 在产品分区新增下拉菜单支持
• 修复中间件导航工具函数中的产品与菜单
• 调整 404 页面文案，使其更清晰

​

10月3日

New releasesImprovements

​

新功能

• 产品导航：使用产品切换器导航，为多个产品组织文档
• 无障碍命令行界面（CLI）命令：运行 mint a11y 测试文档的无障碍问题
• API 操作台中的视频响应：API 操作台现已支持显示视频响应类型
• API 操作台预填：新增选项，可预填 API 操作台示例以更快测试
• 未认证反馈：对使用部分认证的站点，用户现在可在未认证状态下提交反馈
• Shiki 主题支持：现已支持用于代码块样式的 Shiki 主题
• 代码块的 Twoslash：TypeScript 与 JavaScript 代码块现支持 Twoslash 内联类型信息

​

无障碍改进

• 在各组件中添加全面的 ARIA 属性，以更好地支持屏幕阅读器
• 新增“跳转到主内容”按钮，便于键盘导航
• 在 Tab 组件中支持方向键导航
• 增强工具提示、嵌套列表与代码组的无障碍性
• 改进全局焦点状态与键盘交互模式

​

助手与洞察增强

• 为助手 query 分析添加柱状图可视化
• 在助手分析页面统一日期范围选择器
• 为助手分析图表添加缩放控件
• 通过热键与聊天面板改进，更好地管理助手历史

​

错误修复与可靠性

• 修复侧边面板遮罩的 z-index 问题
• 修复浅色模式颜色回退与主题相关样式问题
• 修复 API 操作台中可展开项与锚点链接不兼容的问题
• 修复 .md 链接对 ChatGPT 与其他 LLM agent 的可访问性
• 修复按百分比宽度与高度设置的图片尺寸处理
• 修复带语言标签与自定义主题的代码块渲染问题
• 修复折叠面板链接的格式与样式
• 在助手配置为空时修复页脚间距
• 修复本地存储库图片的卡片 icon 渲染
• 修复 API 操作台中的音频文件处理（防止 UTF-8 解码）
• 改进 Web 编辑器中的 PR 发布状态管理

​

September 26

Improvements

​

语言支持扩展

• 在文档界面中新增对罗马尼亚语和捷克语的支持
• 增强本地化能力，为新语言提供完整翻译覆盖
• 在文档界面中新增对罗马尼亚语和捷克语的支持

​

UI 与用户体验改进

• 修复 404 页面上的标签页可见性问题，防止错误的活动标签页高亮
• 改进图片处理，为未优化的图片正确传递 width 和 height 属性
• 改进 404 页面的布局与样式一致性

​

基础设施与性能增强

• 通过跳过高开销的 Imgix 自动格式化来增强 GIF 处理，减少处理时间和带宽占用
• 通过对动画内容的专项处理优化图片服务性能

​

Bug 修复与可靠性

• 修复控制台设置中 Assistant 附加组件请求的联系邮箱路由
• 改进数据库架构更新以提升用户管理

​

September 19

Improvements

​

Web 编辑器与控制台登录改进

• 持续推进 Web 编辑器的 app router 迁移，移除阻塞并提升性能
• 增强登录错误处理，提供明确的邮箱校验信息
• 修复邮箱地址验证中的空白字符处理

​

认证改进

• 在登录回调中新增对已验证重定向参数的支持，以降低登录阻力
• 改进 SSO 登录流程，优化重定向处理

​

Bug 修复与可靠性

• 修复在大型存储库上的 GitLab 集成问题
• 通过优化部署查询提升控制台加载性能
• 修复文档中的 SVG 路径渲染问题
• 修复搜索与聊天功能中的键盘导航

​

September 13

New releasesImprovements

​

重大发布

• 重大增强：在 404 页面提供 AI 推荐页面，当用户访问死链 → AI 代理读取路径 → 语义推荐相似页面
• 重大发布：AI 助手的网页搜索现可包含外部来源
  注：如需为你的网站启用此功能，请联系我们。

​

AI 助手 与 MCP

• 修复因时间窗口未正确滑动导致 AI 助手被误限流的问题
• 修复助手工具调用未正确处理空 text 块的问题
• 修复将 MCP 服务器名称与工具调用拼接后有时超过 MCP 客户端强制的 60 字符限制的问题
• 修复助手菜单高度远超视口并无限滚动的问题
• 修复控制台中助手花费数值可能显示超过两位小数的问题

​

Web 编辑器与部署

• 增强编辑器安全性，仅具备已连接 Git 托管存储库“写入权限”的用户可进行更改
• 修复包含 = 的 branch 名称无法进行预览部署的问题
• 修复过长的 branch 名称在创建预览部署时导致模态溢出的问题
• 体验优化：在注册邀请中，email query 参数将预填输入框
• 修复通过上下文菜单复制页面在 Safari 上不可用的问题

​

API 操作台 与 导航

• 多个 API 操作台响应码在聚焦时现显示于受控样式的选择菜单，而非系统默认选择菜单
• 你现在可以在 docs.json 的导航 groups 上使用expanded 字段使其默认展开

​

SEO 与 UI

• 通过与各站点的文档站相同的 URL 提供 favicon，修复其在搜索引擎中未显示的问题
• 修复 YouTube 嵌入在加载时闪烁的问题
• 修复展开反馈菜单以包含文字回复时导致目录布局位移的问题
• 修复在 Maple 主题关闭通知横幅后文字会溢出至顶栏之上的问题
• 增强 Maple 与 Willow 主题，在侧边栏新增登录/登出按钮以便更易访问

​

Analytics 与导出

• 修复 AI 助手分析视图与导出的可靠性问题
• AI 助手分析导出现于后台执行并通过电子邮件发送，以获得更可靠的体验

​

8 月 24 日 - 8 月 30 日

Improvements

​

重大版本：增强的反馈收集

• 重大改进：读者在选择“点赞/点踩”后，现在可以提供更细致的反馈，包括选项和文字评论。你还可以对代码块收集反馈，并在控制台的 Analytics 中查看所有反馈。
  注意：请联系我们为你的网站启用此功能。

​

导航与易用性改进

• 易用性改进：忽略结尾斜杠和双斜杠，这样你无需在 docs.json 中精确处理它们
• 你现在可以在 h1-6 HTML 标签上添加 noAnchor 属性，以避免它们生成锚点链接
• Palm 主题现在在左下角提供浮动语言选择器，类似于 Stripe 的做法
• 在 docs.json 中新增字段 drilldown，可控制在展开导航分组时，是否将用户自动导航到该分组的第一篇页面
• 易用性改进：使嵌套有序列表在十进制/罗马数字与字母样式间交替显示

​

错误修复与稳定性

• 修复了当页面存在 JS 组件时，滚动位置锚点链接不正确的问题
• 修复了 Google 会索引原始 *.md 文件的问题，原因是缺少 x-robots-tag: noindex 头
• 修复了受保护文档上的 OAuth 问题：成功完成流程后不会重定向回起始页面
• 修复了受认证保护文档的预览中无法看到完整导航栏的问题
• 修复了在我们的新图片 CDN 下处理 SVG 的相关问题

​

组件与样式增强

• 为 SidebarNavGroupDivider 的自定义样式新增了一个 CSS 选择器
• 为在 MDX 中定义且设置了安全性的 API 页面新增回归测试，以进一步提升稳定性

​

性能改进

• 通过将 KaTeX 的 CSS 从 cdnjs 迁移到我们在 CloudFront 上的自有 CDN 来降低延迟，提升性能

​

8 月 23 日

Improvements

​

图片处理改进

• 重大改进：即使未指定 width 和 height 属性，图片默认也不会引发布局偏移——自动尺寸可在页面加载时防止内容跳动
• 你存储库中的所有静态文件（PDF、TXT、XML 等）现在会在部署时自动上传并提供访问，确保资产完整覆盖

​

Web 编辑器与部署增强

• 修复了 Web 编辑器中的 branch 创建流程，现会正确跳转并停留在新建的 branch 上
• 增强了合并冲突对话框的转义处理，无需再刷新页面即可关闭冲突
• 优化了更新流程性能：在部分更新期间仅对变更页面进行缓存失效处理，缩短部署时间

​

认证与导航改进

• 新增对自定义子目录的认证支持；如果你在 https://yourdomain.com/docs 提供文档，认证现在可无缝工作
• 修复了侧边栏显示问题：当仅配置一个链接时会错误显示
• 全面改进移动端导航：按钮居中并具有合适的边距/内边距；优化下拉菜单的间距；移除空区段中不必要的分隔线与边距；修复 Maple 主题的间距/内边距问题

​

组件与样式修复

• 解决了将 <h1-6> 标签错误转换为 Heading 组件并破坏自定义样式的问题
• 在控制台中新增一键切换 AI 助手配置，便于管理

​

技术改进与可靠性

• 增强了更新流程的日志系统，加快调试与问题定位
• 通过从单文件抓取改为存储库克隆，修复了拥有 10+ OpenAPI/AsyncAPI 规范的客户在 GitHub 上的限流问题
• 提升了 AI 助手的可靠性：增加备用 LLM 支持、改进限流错误处理，以及更健壮的搜索工具功能

​

8月16日

Improvements

​

性能与构建优化

• 在未缓存的 Next.js 无服务器环境中，MDX 转译现已在部署时进行，而非每次页面加载时执行，从而提升未缓存页面的首字节时间（TTFB）。
• 基于内容的哈希可在 MDX 未变化时避免重新转译，将大体量页面客户的更新流程耗时减少约 50%（超过 5 分钟的部署应大致减半）
• 在控制台中查看预览部署现已更快：我们在后端新增数据库索引并并行化了查询
• 通过消除每个页面 rsc 负载中的重复 navigation 数据降低页面体积——在页面数量多或导航结构复杂时性能提升最明显
• 更积极的预取使页面更频繁地实现即刻加载

​

API 操作台与 OpenAPI 增强

• 将 OpenAPI 到 MCP 的转换移至后端，托管的 MCP 服务器可包含工具（更清晰的文档与配置选项即将推出）
• 为 API 操作台新增 Ruby 支持
• 新增功能：现在你可以仅用 docs.json 指定 API 页面，无需创建任何新的 mdx 文件。
• 在文档导航中支持来自 OpenAPI 规范的webhook pages
• 通过在跳转至 Anthropic、OpenAI 或其他提供方时，从 Markdown 链接中移除锚点参数，优化了 AI 模型上下文

​

Web 编辑器改进

• 创建/重命名文件时，点击空白处即可保存更改，而不再需要按 Enter
• 修复了 branch 导航：将 URL 改为特定 branch 时会被重定向到上次活动的 branch，而非目标位置
• 对包含 / 的 branch 标题进行正确的 URL 编码，防止导航异常
• 修复了 monorepo 控制台编辑器中的 Ctrl+K 链接快捷键，之前会在前面加上文档仓库路径并生成错误链接

​

Analytics 与 LLM 集成

• 支持自定义 llms.txt 和 llms-full.txt——将其添加到文档仓库根目录即可在 /llms.txt 和 /llms-full.txt 端点提供，便于自定义 LLM
• 新增 Hightouch 分析集成
• 增强了上下文菜单的分析跟踪（控制台视图即将推出）
• 为 llms.txt 和 llms-full.txt 新增端到端测试，确保正确提供

​

组件与样式增强

• 在 h{1-4} 标签中支持自定义 classnames，以应用自定义标题样式
• 修复了 h{1-4} 标签在自定义页面模式下渲染为带徽标片的 Heading 组件的问题
• 为面包屑添加了 CSS 选择器，便于自定义 CSS 定向
• 通过分析尺寸以在 56px height 下保持比例，修复了被拉伸的 open-graph 图像
• 在上下文菜单中将 VSCode 更正为 VS Code（启用时）
• 修复了自定义组件内的标题与语义标题一同出现在目录中的问题

​

Bug 修复与可靠性

• 通过清理导致生成问题的字符，修复了某些页面标题的 PDF 渲染问题
• 当遇到空的 OpenAPI JSON 文件时，解决了命令行界面（CLI）错误 Cannot convert undefined or null to object
• 修复了自定义 docs.json open-graph 元标签被生成标签覆盖的问题
• 通过对 RSS 链接使用 origin + pathname，修复了在锚点链接落地时 RSS 订阅按钮点击的问题
• 通过移除 sourcemaps 提升了命令行界面（CLI）的下载速度

​

技术改进

• 在 CI 流水线中加入可视化测试，以更早发现回归
• 增强了错误处理与调试能力
• 为新功能与边界情况提供了更全面的测试覆盖

​

8月9日

Improvements

​

认证改进

• 组级公开访问：通过 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 工具的形式暴露

​

AI 助手更新

• 修复了当新消息流入时，旧消息的操作菜单（包含复制、点赞等选项）消失的问题
• 修复了上周托管 MCP 服务器发布后嵌套的 /mcp/... 页面可访问性问题

​

性能与可靠性

• 你仓库中的所有图片和视频资产现在都会在你的 domain 的相应路径提供服务。例如，如果你的仓库中有 /assets/marketing/my-logo.png，它将可通过 https://mydocsurl.extension/assets/marketing/my-logo.png 访问。
• Mintlify 控制台登录页的邮箱输入框现在会自动聚焦，这样你可以立即开始输入（易用性提升）
• 在 Redis 中同时处理自定义域与子域，以提升导航加载性能（约 50ms 时延降低）
• 为 PDF 导出增加了重试逻辑以提升可靠性
• 修复了在同意或关闭后 Cookie 同意弹窗仍会再次出现的问题——现在首次选择会被正确尊重
• 通过在 navigator.write 中指定 MIME type，修复了在 Safari 上复制页面到剪贴板的问题

​

技术改进

• 针对 Windows 和 pnpm 的 命令行界面（CLI） 缺陷修复，并加入 CI 测试以防止回归
• 改进了错误日志输出——为我们工程团队调试带来易用性升级
• 当缺少 contentDirectory 文件时，修复了 broken-link CI 动作的一些小问题
• 修复了上周因受保护预览修复引发的回归问题，该问题导致导航 UI 中的活动标签页未被正确设置
• 修复了主题的 light 背景色未应用到活动 Tab 图标的问题
• 修复了在控制台更改认证类型会先更新然后又切回之前保存类型的问题——现在新选择在保存后会持久生效
• 面向拥有自定义 UI 库的企业客户的内部 DX 改进——我们更容易在更短周期内纳入你的组件并响应需求

​

August 2

Improvements

​

认证改进

• 改善本地环境下的认证开发体验，加快该模块的功能迭代与缺陷修复
• 现已支持对受认证保护站点进行预览部署
• 修复重定向行为，确保认证后正确返回用户的起始页面
• 修复完整认证场景下的登出按钮显示问题（此前仅在部分认证下正常）

​

API 操作台增强

• 修复 API 操作台中的 multipart/form-data 文件上传功能
• 修复锚点链接行为，点击后仅更新 URL，不会滚动到页面顶部
• 修复嵌套选项卡中的锚点链接问题

​

AI 助手更新

• 新增 Assistant API，可集成到你自己的产品中，兼容 AI SDK
• 为聊天回复新增复制按钮
• 修复助手中重试消息的问题
• 优化默认助手提示词，使其默认更为简洁

​

性能与可靠性

• 通过在输入时中止防抖请求，让搜索更为灵敏且准确
• 为新 CDN 配置资源——预计图片与页面加载速度将很快提升
• 修复渲染复杂 Mermaid 图表（如 GANTT）的缺陷
• 修复 Windows 上的 CLI 缺陷以提升稳定性，并新增测试防止回归

​

技术改进

• 在 NextJS 应用中加入 OpenTelemetry 追踪，提升客户的首字节时间（TTFB）
• 从 Octokit 迁移到 GitHub API Client，降低网页编辑器体验中的延迟
• 修复 OpenGraph 的重复 meta 标签
• 将 MongoDB 从 6 升级到 7，以获得更好的性能和新特性

​

July 2025

New releasesImprovements

​

Slack 应用

• 零阻碍访问：Bot 会回复私信、@提及，以及你 #ask-ai 频道中的任何问题
• 一键安装：可在数秒内直接从你的 Mintlify 控制台安装
• 具备上下文的回答：搜索你的整站文档以提供相关且准确的回复
• 降低支持干扰：将日常问题转化为即时的自助式答案

在我们的Slack 应用指南中了解更多。

​

托管 MCP 服务器

通过 Mintlify 直接部署托管的 Model Context Protocol (MCP) 服务器，以集成到 Claude、Cursor 等 AI 工具。详情见我们的 MCP 指南。

通过上下文菜单，帮助用户在文档任意页面快速将你的 MCP 服务器连接到 Cursor 或 VS Code。更多信息参见上下文菜单。

​

代码块改进

• 改进语法高亮
• 新增更多自定义选项，包括专注模式、可展开代码块、深浅色模式自适应、语言下拉菜单、行号与图标

​

June 2025

New releasesImprovements

​

AI 助手更新

• 通过具备工具调用的代理式 RAG 提升准确性
• 提供可导航的引用页面链接，便于用户直接前往答案来源
• 为助手生成的代码示例提供复制快捷方式
• 在文档的代码块上提供“Ask AI”快捷方式，由助手生成解释

在助手文档中了解更多。

​

可订阅的更新日志

• 从更新日志页面自动生成 RSS 源
• 将启用 RSS 的更新集成到 Slack、电子邮件及其他工具

在我们的全新更新日志指南中了解更多

​

May 2025

Improvements

​

API 操作台稳定性更新

• 通过搜索查找端点
• 以标签标注已废弃的端点
• 从导航中隐藏自动生成的 API 页面
• 上传 multipart 或表单数据文件

了解更多：API 操作台文档

​

mint update

现在可以使用 mint update 来更新你的命令行界面（CLI）。

​

2025 年 4 月

New releasesImprovements

​

Web Editor 3.0

全面提升 WYSIWYG（所见即所得）编辑器的易用性。

重大改进

• 使用 ⌘ + P 快捷键按文件名搜索
• 页面加载速度提升至原来的 10 倍
• 搜索 branch 时加载更快
• 页面选项 Tab 可配置布局、标题与用于 SEO（搜索引擎优化）的 metadata
• 选中文本时显示浮动工具栏

其他修复

• 修复更新日志组件的顶部外边距
• 提升右键交互的可靠性
• 点击发布后将停留在当前页面，而非跳转到空状态
• 统一文件 icon 的颜色
• 连续多次选择新 branch 后的稳定性改进
• 移除 Diff 模式
• 通过下拉菜单新建文件夹时的一致性更高
• 修复尝试取消选择时引用块会继续创建更多引用块的问题

​

AI 翻译（测试版）

使用 AI 翻译你的全部文档。了解更多。

​

导出文档为 PDF（测试版）

将全部文档、某个子目录或单个页面导出为 PDF。

​

支持 React hook

为文档带来交互能力。所有标准的 React hooks 在你的 MDX 文件中将自动可用。了解更多。

​

2025 年 3 月

New releasesImprovements

​

MCP 服务器生成器

生成 MCP 服务器，让 AI 应用能够与你的文档或 API 交互。书面内容会自动生成为 MCP 服务器，你也可以一键从 OpenAPI 规范生成 MCP 服务器。查看MCP 入门文档。

​

改进

• 为更新日志添加标签，便于终端用户筛选更新
• AI Chat 支持 Sonnet-3.7。可在控制台配置你偏好的模型
• 可在控制台设置中直接更改部署名称

​

Bug 修复

• 修复 OG 图片
• 修复无容器锚点的 icon 样式不一致
• 优化控制台边框样式细节，提升在移动端/平板/桌面端的响应式表现
• 在 API 操作台的简洁模式下也显示代码示例
• Web 编辑器支持 “command + k” 搜索快捷键
• Callout 内的代码块将扩展以填满 Callout 区域的宽度

​

2025年2月

New releasesImprovements

​

新的配置架构 docs.json

我们引入了全新的 docs.json 架构以取代 mint.json，以支持更强的多级版本管理、更易理解的可视化结构，以及更一致的术语。了解更多变更内容，请查看我们的博客。

按以下步骤从 mint.json 升级到 docs.json：

1. 确保你的命令行界面（CLI）为最新版本

npm i mint@latest -g

1. 在你的文档存储库中运行

mint upgrade

1. 删除旧的 mint.json 文件并推送你的更改

​

CI 检查

自动对文档进行 lint，查找失效链接、拼写和语法问题，或使用你自己的 Vale 配置来约束写作风格。详见我们的文档。

​

面向 LLM 的 .md 支持

所有文档页面现已自动提供为纯 Markdown 文件——只需在 URL 末尾追加 .md。这便于 LLM 吸收你的文档中单个页面的内容。

​

更多主题

新增预构建主题，用于调整文档的外观与体验。可通过你的 docs.json 文件 进行配置。

现已提供：

• Maple
• Palm
• Willow

​

其他改进

• 技术写作指南：编写技术文档的最佳实践，包括受众研究、内容类型与写作技巧。
• Dropdown 组件：除 Tabs 和锚点外，可使用下拉菜单组织导航。
• AI 语法修复器：网页编辑器若检测到解析错误，将使用 AI 提出修复建议。

​

2025年1月

Improvements

​

AI 助手改进

• 全新的 UI，提供专用聊天页面与预填提示
• 稳定性提升。例如，修复误编辑到错误文件或未编辑任何文件的问题
• 更健全的组件添加与编辑相关知识
• 优化 docs.json 文件编辑体验

​

部分认证

可根据用户权限自定义对任意页面或内容分区的访问。支持接入你自有的认证系统。

​

全面焕新的 API 操作台

我们对 API 操作台 的设计与性能进行了全面升级。更新包括：

• 更便捷地展开详情以查看字段概览
• 更直观的嵌套交互。例如，添加或删除条目
• 更快的响应时间

​

质量改进

• 支持要求认证后才能访问预览部署

​

2024年12月

​

认证

通过设置 JWT（JSON Web Token）、OAuth 或通用密码，使文档仅限私有访问。借助该隐私控制，你可以创建内部知识库，或防止竞争对手查看你的文档。

​

November 2024

​

AI Writer

现在你可以在结合所有现有文档的上下文下，请求 AI 对文档进行修改。输入提示后，Writer 会通过生成拉取请求（PR）来提出修改建议。

​

GitLab 集成升级

我们改进了与 GitLab 的同步支持，例如启用自动更新和预览部署。查看我们的GitLab 文档以开始使用。

​

Web Editor

我们重构了 Web Editor，现在你可以在与 Markdown 同步的同时，以完整的 WYSIWYG（所见即所得）体验来更新文档。

查看我们的Web Editor 入门文档。

​

/llms.txt 支持

所有文档站点现在都会自动在 /llms.txt 和 /llms-full.txt 提供服务，便于 LLM 轻松摄取你的文档。更多信息请阅读新的 llms.txt 标准文档。

​

本地化

你现在可以对文档进行本地化，其工作方式与版本管理类似。为某个版本添加一个 locale 后，Mintlify 中固定的内容（如 “Was this page helpful?”）也会匹配该 locale。

​

质量改进

• 基于用户当前阅读的版本返回聊天与搜索结果
• 除了 JWT 或 Shared Session 令牌外，新增支持使用 OAuth 对用户进行身份验证

​

2024 年 10 月

​

更新日志

推出全新的 Update 组件，让你更轻松地向用户展示并告知更新（就像这条一样）。

​

代码行高亮

你现在可以在文档中高亮代码行：在语言标识后添加特殊注释，以突出重要部分。使用花括号 {}，并用逗号分隔指定的行号或范围。

Line Highlighting Example

const greeting = "Hello, World!";
function sayHello() {
  console.log(greeting);
}
sayHello();

```javascript Line Highlighting Example {1,3-5}
const greeting = "Hello, World!";
function sayHello() {
  console.log(greeting);
}
sayHello();
```

​

浅色模式代码块

代码块现在提供浅色模式变体，可通过在你的 docs.json 中添加以下内容启用：

"codeBlock": {
  "mode": "auto"
}

​

高级页脚

你现在可以在标准页脚中添加更多链接。此升级让着陆页与文档间的体验更一致；如果你想突出显示特定页面（如社交或状态页），也可进行更灵活的自定义。

​

基于当前用户的搜索筛选

启用个性化后，搜索结果将基于当前登录用户进行筛选，仅显示相关内容。

​

AI Chat 的自定义提示词

你现在可以自定义 AI 聊天的提示词。如果你希望自定义提示词，请联系 support。

​

控制台改进

• 新增可通过控制台设置将自定义 domain 直接更改为 /docs 的功能。
• 合并登录与注册页面，降低阻碍与困惑。
• 实现发现式登录流程，使属于多个组织的用户可以在其间切换。
• 新增使用 Google OAuth 登录。
• 新增可通过控制台设置添加新的部署的功能。

​

缺陷修复

• 现在可以在 navigation 中使用前导斜杠。
• 现在可以在网页编辑器中编辑 CSS 与 JS 文件。
• 修复了即使启用也不显示 suggestEdit 的问题。
• 修复了搜索与聊天的键盘导航，现在可以使用上下方向键浏览结果。
• 不允许搜索引擎抓取受用户身份验证保护的页面。
• 删除组织时重新验证缓存。
• 现使用 Scalar OpenAPI 解析器解析 OpenAPI 定义，提升性能、修复解析问题，并提供更清晰的错误信息。
• 现在支持在由 OpenAPI 定义自动生成的 API 参考页面中显示顶层 description。
• 为 icon 提供内联样式支持。
• 修复了文档中自定义 CSS 的闪入问题。
• 在存在链接的情况下，正确显示行内代码样式。
• 在浏览器中点击返回按钮时保持滚动位置。

​

2024年9月

​

自定义字体

你可以将文档字体设置为托管在 CDN 上的自有字体，或从 Google Fonts 中选择，使文档更契合你的品牌。

​

Card 组件中的图片

在卡片上添加一个 img 属性即可在卡片顶部显示图片。了解更多内容请见这里。

​

更新速度优化

对于大型项目（约 3,000 个文件），文档更新的下载步骤现已提速约 440 倍——用时减少 99.8%。整体而言，更新过程中下载文件的速度现已提升约 5.5 倍——用时减少 81.8%。

​

SEO 改进

我们修复了文档在移动端和桌面端的布局，使其更符合 SEO（搜索引擎优化）要求——包括为导航栏和切换元素添加合适的 aria 标签。

​

控制台改进

• 控制台完成 App router 迁移。
• 控制台中现已提供搜索分析。
• 控制台中已添加删除组织功能。
• 上线了 GitLab 连接 UI。
• 修复了不正确的分析数据。
• 现在可通过控制台直接购买附加组件。

​

错误修复

• 修复了在自定义模式且侧边栏布局为 sidenav 时，顶部栏未能延伸至屏幕宽度的问题。
• 修复了 AI 小部件的相对定位问题。

​

更多

• API 页面疑难解答：API 页面可能较为复杂，因此我们列出了常见问题，帮助你快速排查——阅读文档

​

2024年8月

​

OpenAPI 参考页面

• 由 OpenAPI 定义的复杂且递归的端点现在体积缩小 98%。
• 我们现在在 OpenAPI 页面中展示 additionalProperties。

​

API 操作台中的文件上传

默认情况下，API 操作台的请求由 Mintlify 进行代理。现在你可以使用 disableProxy 禁用该行为，并支持文件上传等请求类型。

• 了解更多 API 配置

​

移动端 SEO 改进

我们修复了文档的移动端布局，使其更符合 SEO（搜索引擎优化）要求——包括为元素添加合适的 aria 标签。

​

支持表单

我们在 Mintlify 控制台中新增了更详细的支持表单。现在你可以提交表单与我们联系。

​

错误修复

• 修复了 Segment 集成功能的一个问题。
• 与编辑器交互时，我们现在会针对 GitHub 权限提供更细化的错误信息。
• 修复了使用直接链接时导航无法正确展开的问题。

​

2024年7月

​

AI 小部件

面向 Pro 用户，我们推出了 Mintlify Widget，这是你文档的延伸，可在用户提出问题的时间和地点即时作答。你可以将这个由 AI 驱动的聊天机器人添加到任意网页：你的首页、产品内页面，或现有的文档页面。

• 阅读博客公告

​

Pro 方案

我们也更新了定价方案，以获得更好的可定制性和扩展性。

• 阅读博客公告

​

API 操作台代码示例同步

当你浏览 API 文档时，所选代码示例现在会在页面之间同步。

​

Insights

目前处于测试阶段，该功能将常见用户问题与模式汇总为易于理解的报告，并提供由 AI 驱动的产品优化建议。

​

2024年6月

​

发布周亮点

• 主题：使用预配置主题自定义样式。只需将 Quill、Prism 或 Venus 主题添加到你的 docs.json 文件中，即可更新文档样式。
• 搜索 V2：可直接检索 OpenAPI 端点的说明和标题，快速抵达 API 参考页面；从搜索中排除隐藏页面，并体验我们升级后的搜索栏 UI。
• Web 编辑器分支：无需 IDE，即可在我们的 Web 编辑器中创建分支。
• 用户个性化：通过 Shared Session 或 JWT（JSON Web Token）对用户进行认证，以便展示定制内容，例如预填 API key 或为特定客户显示专属内容。
• OpenAPI 自动化升级：为自动填充 API 操作台页面，你可以在 docs.json 的 tabs 或 anchors 数组中的对象里添加一个 openapi 字段。

​

2024年5月

​

Okta 单点登录（SSO）

我们现已支持通过 Okta 的 SAML 和 OIDC 登录。

​

Mintlify REST API

以编程方式触发文档更新。

​

2024年4月

​

自定义模式

在 metadata 中添加配置，以移除除顶部栏之外的所有元素。示例用法：

• 使用自定义组件创建全局自定义落地页
• 添加全屏视频或图片库
• 嵌入自定义 iFrame 演示元素，为你的文档增加交互性

查看我们的自定义模式文档。

​

2024年3月

​

面向 VSCode 的 Mintlify MDX

无需离开 VSCode，即可调用我们预构建组件和提示的代码片段。在此安装扩展。

​

2024年2月

​

质量改进

• 控制台升级：查看更新日志以了解变更内容和更新状态；在不同 Mintlify 项目间切换以管理部署
• 完整支持基于 Tabs 的版本管理
• 支持通配符重定向
• 命令行界面（CLI）错误检测：本地开发解析出现问题时，我们现在会显示无效 frontmatter 的位置

​

2024年1月

​

发布周亮点

• 预览部署：当你创建拉取请求（PR；亦称“合并请求”/Merge Request）时，我们会生成一个唯一链接，实时预览你的文档在生产环境中的效果。你可以将该链接分享给队友。
• 代码片段 V2：我们现在支持完全可复用的组件和变量，用于片段。
• 开源 MDX 引擎：我们开放了两个 API——getCompiledMdx 和 MDXComponent——以便你使用 Mintlify 的 Markdown 与代码语法高亮。欢迎为该项目贡献。
• AI 聊天洞察：按日期分段聊天历史、在控制台中提升 AI Chat 配额，并查看特定 query 的出现频率。