搜索加权

通过在页面 frontmatter 或 docs.json 导航中设置数值加权乘数，使你的文档站点内置搜索的排名向特定页面或章节倾斜。

使用 boost 让特定页面或章节在站内搜索中获得更高的排名权重。该值是一个应用于每个内容片段相关性得分的数值乘数：boost: 3 会使某个片段的相关性提升为没有加权时的三倍。

boost 仅影响 Mintlify 托管的文档站点上的搜索栏。它不会改变外部搜索引擎对你页面的索引方式。

​

为单个页面加权

在页面的 frontmatter 中设置 boost，可放大其搜索排名。

---
title: "Custom domain"
description: "Connect your custom domain to your Mintlify documentation."
boost: 3
---

​

为导航分组加权

在 docs.json 导航中的某个分组上设置 boost，可将该乘数应用于其下的每个页面。

{
  "navigation": {
    "groups": [
      {
        "group": "Get started",
        "boost": 5,
        "pages": [
          "quickstart",
          "concepts"
        ]
      }
    ]
  }
}

页面会从最近一个设置了加权值的祖先那里继承加权因子。子页面或嵌套分组可以通过设置自己的 boost 值来覆盖继承的加权。页面 frontmatter 中的 boost 始终优先于从导航继承的值。

​

降低内容优先级

使用小于 1 的值可将页面在搜索结果中下推。例如，boost: 0.5 会将页面的相关性得分相对于其他页面减半。boost 为 1 时等同于不加权。

---
title: "Deprecated API"
description: "Documentation for the deprecated v1 API."
boost: 0.25
---

加权因子会与已有的相关性得分相乘。请谨慎使用。过大的乘数会导致相关性较低的页面在搜索结果中占据主导地位，从而降低整体搜索质量。

​

调整搜索结果数量

默认情况下，文档站点的搜索栏每次查询最多返回 6 个结果。要返回更多（或更少）结果，请在仪表盘中更改 Maximum search results 设置。

1. 在仪表盘中前往 Project Settings → Search。
2. 使用步进控件选择 1 到 100 之间的值。
3. 选择 Save changes。

新的上限会应用于来自文档站点的每个搜索请求。返回更多结果可以提高合适页面被看到的概率，但数值过大可能会让搜索面板更难浏览。

你需要 deployment.update 权限才能更改此设置。该设置在 Atlas（自托管）部署中不可用。