跳转到主要内容
在页面中添加 Update 组件,即可为你的文档创建更新日志。 查看 Mintlify 更新日志 作为示例:每次更新都可以包含链接、图片、文本以及新功能演示。

设置更新日志

1

为更新日志创建页面

  1. 在文档中创建一个新页面,例如 changelog.mdxupdates.mdx
  2. 将更新日志页面添加到 docs.json 的导航配置中。
2

在更新日志中添加 Update 组件

为每条更新日志记录添加一个 Update包含相关信息,例如功能发布、错误修复或其他公告。
Example changelog.mdx
---
title: "更新日志"
description: "产品更新和公告"
---
<Update label="2025年3月" description="v0.0.10">
  新增冬青薄荷口味。

  绿薄荷口味发布新版本,薄荷含量提升10%。
</Update>

<Update label="2025年2月" description="v0.0.09">
  绿薄荷口味发布新版本。
</Update>

自定义更新日志

控制用户浏览更新日志的方式,并让他们及时掌握产品动态。

目录

每个 Updatelabel 属性都会在右侧侧边栏的目录中自动创建一个条目。这是你的更新日志的默认导航方式。
浅色模式下显示目录的更新日志。

标签筛选

Update 组件中添加 tags,即可将目录替换为标签筛选器。用户可以通过选择一个或多个标签来筛选更新日志:
Tag filters example
<Update label="2025年3月" description="v0.0.10" tags={["Wintergreen", "Spearmint"]}>
  添加了新的 Wintergreen 口味。

  发布了新版本的 Spearmint 口味,现在薄荷含量增加了 10%。
</Update>

<Update label="2025年2月" description="v0.0.09" tags={["Spearmint"]}>
  发布了新版本的 Spearmint 口味。
</Update>

<Update label="2025年1月" description="v0.0.08" tags={["Peppermint", "Spearmint"]}>
  已废弃 Peppermint 口味。

  发布了新版本的 Spearmint 口味。
</Update>
浅色模式下的更新日志,已选中 Peppermint 标签筛选器。
在使用 customcenterwide 页面模式时,目录和更新日志筛选器会被隐藏。了解更多页面模式

可订阅的更新日志

使用 Update 组件会在你的页面 URL 后追加 /rss.xml,从而创建一个可订阅的 RSS 源。例如:mintlify.com/docs/changelog/rss.xml 当发布新的 Update 组件,或在现有的 <Update> 标签内添加新标题时,RSS 源会新增条目。 Update 组件的顶级标题将作为 RSS 条目的标题,这些条目会链接到文档中对应标题的锚点。
Example RSS feed
<?xml version="1.0" encoding="UTF-8"?>
<rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0">
  <channel>
    <title><![CDATA[产品更新]]></title>
    <description><![CDATA[新功能更新与改进]]></description>
    <link>https://mintlify.com/docs</link>
    <generator>RSS for Node</generator>
    <lastBuildDate>Mon, 21 Jul 2025 21:21:47 GMT</lastBuildDate>
    <atom:link href="https://mintlify.com/docs/changelog/rss.xml" rel="self" type="application/rss+xml"/>
    <copyright><![CDATA[Mintlify]]></copyright>
    <docs>https://mintlify.com/docs</docs>
    <item>
      <title><![CDATA[2025年6月]]></title>
      <link>https://mintlify.com/docs/changelog#june-2025</link>
      <guid isPermaLink="true">https://mintlify.com/docs/changelog#june-2025</guid>
      <pubDate>Mon, 23 Jun 2025 16:54:22 GMT</pubDate>
    </item>
  </channel>
</rss>
RSS 源可与 Slack、电子邮件或其他订阅工具集成,用于通知用户产品更新。可选方案包括: 为便于发现 RSS 源,你可以在页面顶部显示一个链接到该源的 RSS icon 按钮。在页面 frontmatter 中添加 rss: true
---
rss: true
---
浅色模式下启用 RSS 订阅按钮的更新日志页面。
I