Changelog

API catalog discovery

AI agents, MCP clients, and API catalog crawlers can now discover your APIs automatically. Every Fern Docs site exposes a standards-based (RFC 9727) /.well-known/api-catalog endpoint generated from your visible API Reference navigation.

Redesigned dynamic OG images

Dynamic OG images have a new layout with fine-grained control over the logo variant, text and background colors, and which elements appear (section, description, URL, gradient).

1
metadata:
2
  og:dynamic: true
3
  og:dynamic:background-image: ./images/og-background.png
4
  og:dynamic:text-color: "#1a1a1a"
5
  og:dynamic:background-color: "#ffffff"
6
  og:dynamic:logo-color: dark
7
  og:dynamic:show-logo: true
8
  og:dynamic:show-section: true
9
  og:dynamic:show-description: true
10
  og:dynamic:show-url: true
11
  og:dynamic:show-gradient: true

全局主题

在单个控制仓库中定义您的文档品牌，并在多个网站之间共享。使用 fern docs theme CLI 命令导出、上传和管理主题，然后在任何子仓库的 docs.yml 中通过 global-theme 属性按名称引用主题。

“连接到 Claude Code” 页面操作

启用了 Ask Fern 的 Fern Docs 网站现在会在现有页面操作旁显示”连接到 Claude Code”按钮。点击按钮会复制一个 claude mcp add 命令。读者可以将其粘贴到终端中，以将您网站的 MCP 服务器注册到 Claude Code。

此操作默认启用，可以通过在 docs.yml 中设置 page-actions.options.claude-code: false 来关闭。

在合并时清理 GitHub Actions 预览部署

GitHub Actions 预览工作流 现在有一个可选的配套 cleanup-preview.yml 工作流，可以在 PR 合并后删除拉取请求的预览部署，这样过期的预览就不会留存。

要采用此工作流，请在现有预览工作流旁边添加 .github/workflows/cleanup-preview.yml。

合并时清理 GitLab 预览部署

更新的 GitLab CI/CD 流水线现在包含一个 cleanup_preview 阶段，在合并请求合并到默认分支后删除该 MR 的预览部署，避免陈旧的预览残留。

要采用此工作流程，请用更新的版本替换您的 .gitlab-ci.yml 文件。

从自定义脚本定位 logo

<Fern.Logo /> 现在渲染时带有 data-fern-logo 属性，因此自定义脚本可以使用 document.querySelector('#fern-header [data-fern-logo]') 定位 logo。使用它在特定页面重写 logo 的 href 或修改其他行为。

移动端目录栏

使用 guide 和 overview 布局的页面现在可以在移动端和平板设备视口中在头部下方显示粘性目录栏。该栏显示滚动进度指示器和当前标题，点击时展开为完整目录。

在 docs.yml 的 layout 下添加 mobile-toc: true 来启用：

1
layout:
2
  mobile-toc: true

AI 搜索模型更新

Ask Fern 现在使用 Claude 4.6 Sonnet 和 Claude 4.5 Haiku。

使用 api: 语法链接到 API Reference 部分

api: 链接语法现在支持链接到 API Reference 部分的根目录。使用 api:apiName 创建一个在构建时解析到特定 API Reference 着陆页的链接。这在您的项目有多个 API 时很有用。

1
Explore the [Plant Store API](api:plant-store) reference.

AsyncAPI 规范端点

对于包含 WebSocket 通道的站点，Fern 文档站点在 /asyncapi.json 和 /asyncapi.yaml 提供您的原始 AsyncAPI 2.6.0 规范。下载它用于客户端生成、合约测试或导入到兼容 AsyncAPI 的工具中。该规范也从您站点的 llms.txt 链接，因此 AI 编码助手可以自动发现和使用它。