跳转到主要内容
上下文菜单可快速访问经AI优化的内容,并直接对接主流AI工具。用户在任意页面打开上下文菜单时,可以将内容复制为AI工具的上下文,或在 ChatGPT、Claude、Perplexity,或你自定义的工具中发起对话,并自动将你的文档作为上下文加载。 上下文菜单包含多个内置选项,你可以在配置中添加对应的标识符来启用。
选项标识符描述
复制页面copy将当前页面复制为 Markdown,便于作为上下文粘贴到 AI 工具中
以 Markdown 查看view以 Markdown 形式打开当前页面
在 ChatGPT 中打开chatgpt以当前页面为上下文创建一个 ChatGPT 对话
在 Claude 中打开claude以当前页面为上下文创建一个 Claude 对话
在 Perplexity 中打开perplexity以当前页面为上下文创建一个 Perplexity 对话
复制 MCP 服务器 URLmcp将你的 MCP 服务器 URL 复制到剪贴板
连接到 Cursorcursor在 Cursor 中安装你托管的 MCP 服务器
连接到 VS Codevscode在 VS Code 中安装你托管的 MCP 服务器
展开的上下文菜单,显示“复制页面”、“以 Markdown 查看”、“在 ChatGPT 中打开”和“在 Claude 中打开”等菜单项。

启用上下文菜单

在你的 docs.json 文件中添加 contextual 字段,并指定要包含的选项。
{
 "contextual": {
   "options": [
     "复制",
     "查看",
     "ChatGPT",
     "Claude",
     "Perplexity",
     "MCP",
     "Cursor",
     "VS Code"
   ]
 }
}

添加自定义选项

通过向 options 数组添加一个对象,可在上下文菜单中创建自定义选项。每个自定义选项需要包含以下属性:
title
string
required
选项标题。
description
string
required
选项描述。展开上下文菜单时显示在标题下方。
icon
string
required
要显示的图标。可选值:
  • Font Awesome 图标 的名称
  • Lucide 图标 的名称
  • 用花括号包裹的、可用于 JSX 的 SVG 代码
  • 指向外部托管图标的 URL
  • 项目中图标文件的路径
关于自定义 SVG 图标:
  1. 使用 SVGR 转换器 将 SVG 转换。
  2. 将你的 SVG 代码粘贴到 SVG 输入框中。
  3. 从 JSX 输出框中复制完整的 <svg>...</svg> 元素。
  4. 用花括号包裹可用于 JSX 的 SVG 代码:icon={<svg ...> ... </svg>}
  5. 按需调整 heightwidth
iconType
string
Font Awesome 的图标样式。仅在使用 Font Awesome 图标时生效。可选值:regularsolidlightthinsharp-solidduotonebrands
href
string | object
required
选项的 href。简单链接使用字符串,带查询参数的动态链接使用对象。
自定义选项示例:
{
    "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"
      }
    ]
  }
}