上下文菜单

上下文菜单可快速访问经AI优化的内容，并直接对接主流AI工具。用户在任意页面打开上下文菜单时，可以将内容复制为AI工具的上下文，或在 ChatGPT、Claude、Perplexity，或你自定义的工具中发起对话，并自动将你的文档作为上下文加载。上下文菜单包含多个内置选项，你可以在配置中添加对应的标识符来启用。

选项	标识符	描述
复制页面	`copy`	将当前页面复制为 Markdown，便于作为上下文粘贴到 AI 工具中
以 Markdown 查看	`view`	以 Markdown 形式打开当前页面
在 ChatGPT 中打开	`chatgpt`	以当前页面为上下文创建一个 ChatGPT 对话
在 Claude 中打开	`claude`	以当前页面为上下文创建一个 Claude 对话
在 Perplexity 中打开	`perplexity`	以当前页面为上下文创建一个 Perplexity 对话
复制 MCP 服务器 URL	`mcp`	将你的 MCP 服务器 URL 复制到剪贴板
连接到 Cursor	`cursor`	在 Cursor 中安装你托管的 MCP 服务器
连接到 VS Code	`vscode`	在 VS Code 中安装你托管的 MCP 服务器

展开的上下文菜单，显示“复制页面”、“以 Markdown 查看”、“在 ChatGPT 中打开”和“在 Claude 中打开”等菜单项。

在你的 docs.json 文件中添加 contextual 字段，并指定要包含的选项。

{
 "contextual": {
   "options": [
     "复制",
     "查看",
     "ChatGPT",
     "Claude",
     "Perplexity",
     "MCP",
     "Cursor",
     "VS Code"
   ]
 }
}

添加自定义选项

通过向 options 数组添加一个对象，可在上下文菜单中创建自定义选项。每个自定义选项需要包含以下属性：

string

必填

选项标题。

string

必填

选项描述。展开上下文菜单时显示在标题下方。

string

必填

要显示的图标。可选值：

Font Awesome 图标的名称
Lucide 图标的名称
用花括号包裹的、可用于 JSX 的 SVG 代码
指向外部托管图标的 URL
项目中图标文件的路径

关于自定义 SVG 图标：

使用 SVGR 转换器将 SVG 转换。
将你的 SVG 代码粘贴到 SVG 输入框中。
从 JSX 输出框中复制完整的 <svg>...</svg> 元素。
用花括号包裹可用于 JSX 的 SVG 代码：icon={<svg ...> ... </svg>}。
按需调整 height 和 width。

string

Font Awesome 的图标样式。仅在使用 Font Awesome 图标时生效。可选值：regular、solid、light、thin、sharp-solid、duotone、brands。

string | object

必填

选项的 href。简单链接使用字符串，带查询参数的动态链接使用对象。

显示 href object

string

必填

该选项的基础 URL。

object

必填

该选项的查询参数。

显示 query object

string

必填

查询参数的键。

string

必填

查询参数的值。我们会将以下占位符替换为对应的值：

使用 $page 插入当前页面的 Markdown 内容。
使用 $path 插入当前页面路径。
使用 $mcp 插入托管的 MCP 服务器 URL。

自定义选项示例：

{
    "contextual": {
        "options": [
            "copy",
            "view",
            "chatgpt",
            "claude",
            "perplexity",
            {
                "title": "功能需求",
                "description": "前往 GitHub 参与讨论并提交新功能请求",
                "icon": "plus"
                "href": "https://github.com/orgs/mintlify/discussions/categories/feature-requests"
            }
        ]
    }
}

自定义选项示例

简单链接

{
  "title": "请求新功能",
  "description": "在 GitHub 上参与讨论",
  "icon": "plus",
  "href": "https://github.com/orgs/mintlify/discussions/categories/feature-requests"
}

包含页面内容的动态链接

{
  "title": "在 X 上分享",
  "description": "将此页面分享到 X",
  "icon": "x",
  "href": {
    "base": "https://x.com/intent/tweet",
    "query": [
      {
      "key": "text",
      "value": "查看这份文档：$page"
      }
    ]
  }
}

快速入门

核心配置

AI 优化

组件

API 页面

认证与个性化

指南

集成

版本控制与CI/CD

菜单选项

启用上下文菜单

添加自定义选项

自定义选项示例

​菜单选项

​启用上下文菜单

​添加自定义选项

​自定义选项示例

菜单选项

启用上下文菜单

添加自定义选项

自定义选项示例