隐藏页面

将页面从导航中隐藏，同时保持可访问性。

隐藏页面不会出现在站点的导航中，但任何知道该 URL 的人仍然可以访问它们。比如，如果你创建了一个像 guides/hidden-page.mdx 这样的隐藏页面，访问者依然可以通过 docs.yoursite.com/guides/hidden-page 打开它。

当你希望用户能够访问某些内容，或将其作为 AI 工具的上下文引用，但又不希望这些内容出现在导航中时，可以使用隐藏页面。

如果你的内容需要严格的访问控制，必须配置认证。

要将页面限制为特定用户组访问，请设置基于用户组的访问控制。

参见隐藏页面示例。

某些导航元素，如侧边栏、下拉菜单和选项卡，在隐藏页面上可能会显示为空或导致布局发生变化。

​

隐藏页面

要隐藏页面，请在页面的 frontmatter 中设置 hidden: true，或将其从 docs.json 的 navigation 中移除。

​

在 frontmatter 中设置 hidden: true

在页面的 frontmatter 中添加 hidden: true，可以将该页面从渲染的导航中移除，同时仍然将其包含在 docs.json 配置中。

---
title: "My hidden page"
hidden: true
---

搜索引擎无法对设置了 hidden: true 的页面进行索引编入。有关更多信息，请参阅禁用索引编入。

​

从导航中移除页面

如果你没有在 docs.json 的 navigation 中包含某个页面，该页面就会被隐藏。这种方式非常适合那些你根本不希望出现在导航中的页面。

​

隐藏一组页面

若要隐藏一组页面，请在你的 docs.json 文件中将该页面分组的 hidden 属性设为 true：

"groups": [
  {
    "group": "快速开始",
    "hidden": true,
    "pages": [
      "index",
      "quickstart"
    ]
  },
  {
    "group": "Guides",
    "pages": [
      "guides/hidden-page.mdx",
      "guides/hidden-groups.mdx"
    ]
  }
]

在此示例中，Getting started 组被隐藏，并且 Guides 组可见。

​

隐藏标签页

要隐藏某个标签页，请在 docs.json 文件中为该标签页添加 hidden 属性：

"tabs": [
  {
    "tab": "首页",
    "hidden": true,
    "pages": [
      "index",
      "quickstart"
    ]
  }
]

​

搜索、SEO 与 AI 索引编入

默认情况下，隐藏页面不会被纳入搜索引擎的索引、文档站点的内部搜索，也不会作为 AI 助手的上下文使用。若要在搜索结果中包含隐藏页面并将其作为 AI 助手的上下文，请在你的 docs.json 中添加 seo 属性：

"seo": {
    "indexing": "all"
}

要排除某个特定页面，请在其 frontmatter 中添加 noindex: true。