隐藏页面会从你的网站导航中移除,但任何知道其 URL 的人仍可公开访问。 当你希望内容在站点上可访问,或可被 AI 工具用作上下文引用,但又不希望通过导航被发现时,请使用隐藏页面。 对于需要严格访问控制的内容,必须配置身份验证 如果你想仅对特定用户群体隐藏页面,请使用个性化来控制页面可见性

隐藏页面

如果某个页面未包含在你的 docs.json 导航中,它就是隐藏的。要隐藏页面,请将其从导航结构中移除。 隐藏页面会根据其文件路径使用与常规页面相同的 URL 结构。比如,guides/hidden-page.mdx 可通过 docs.yoursite.com/guides/hidden-page 访问。 查看隐藏页面示例
某些导航元素(如侧边栏、下拉菜单和选项卡)在隐藏页面上可能会显示为空或导致布局偏移。

隐藏一组页面

如果在 docs.json 文件中将 hidden 属性设置为 true,该页面组将被隐藏:
"groups": [
  {
    "group": "Getting started",
    "hidden": true,
    "pages": [
      "index",
      "quickstart"
    ]
  },
  {
    "group": "Guides",
    "pages": [
      "guides/hidden-page.mdx",
      "guides/hidden-groups.mdx"
    ]
  }
]
在此示例中,Getting started 组被隐藏,而 Guides 组可见。

隐藏选项卡

你也可以在 docs.json 文件中为对应选项卡添加 hidden 属性来将其隐藏:
"tabs": [
  {
    "tab": "Home",
    "hidden": true,
    "pages": [
      "index",
      "quickstart"
    ]
  }
]

搜索、SEO 与 AI 索引

默认情况下,隐藏页面不会被搜索引擎、文档内搜索,或用作 AI 助手的上下文进行索引。若要将隐藏页面纳入搜索结果并作为助手的上下文,请在你的 docs.json 中添加 seo 属性:
"seo": {
    "indexing": "all"
}
要排除某个特定页面,请在其 frontmatter 中添加 noindex: "true"