外观与品牌

文档的主色。通常在浅色模式下用于强调，具体因主题而异。

必须是以 # 开头的十六进制代码。示例："#0D9373"。

在深色模式下用于强调的颜色。

必须是以 # 开头的十六进制代码。

在浅色和深色模式下用于按钮和悬停状态的颜色，具体因主题而异。

必须是以 # 开头的十六进制代码。

浅色模式下 logo 文件的路径。包含文件扩展名。示例：/logo/light.svg。

深色模式下 logo 文件的路径。包含文件扩展名。示例：/logo/dark.svg。

点击 logo 时重定向到的 URL。如果未提供，对于国际化文档，logo 链接到当前所选区域设置的第一页，对于单语言站点则链接到首页。示例：https://yoursite.com。

浅色模式下 favicon 的路径。包含文件扩展名。示例：/favicon.png。

深色模式下 favicon 的路径。包含文件扩展名。示例：/favicon-dark.png。

默认颜色模式。选择 system 以匹配用户操作系统设置，或选择 light 或 dark 强制使用特定模式。默认为 system。

当为 true 时，隐藏浅色/深色模式切换，使用户无法切换模式。默认为 false。

字体系列名称，如 "Inter" 或 "Open Sans"。支持 Google Fonts 系列名称——这些会自动加载，无需 source。

字体粗细，如 400 或 700。可变字体支持小数粗细，如 550。

托管字体的 URL 或本地字体文件的路径。Google Fonts 不需要此项。

• 托管：https://example.com/fonts/MyFont.woff2
• 本地：/fonts/MyFont.woff2

字体文件格式。使用 source 字段时必需。

仅用于标题的字体设置覆盖。

接受与顶级 fonts 对象相同的 family、weight、source 和 format 字段。

仅用于正文的字体设置覆盖。

接受与顶级 fonts 对象相同的 family、weight、source 和 format 字段。

在整个文档中使用的图标库。默认为 fontawesome。

主题的装饰背景图案。

浅色和深色模式的自定义背景颜色。

站点的背景图片。提供单个路径或为浅色和深色模式提供单独的路径。

页面 eyebrow 的样式（页面顶部显示的标签）。选择 section 显示章节名称，或选择 breadcrumbs 显示完整导航路径。默认为 section。

控制是否加载 LaTeX 样式表。默认情况下，Mintlify 会自动检测内容中的 LaTeX 使用并加载必要的样式表。

• 设置为 true 可在自动检测失败时强制加载 LaTeX 样式表。
• 如果你不使用数学表达式，设置为 false 可阻止加载 LaTeX 样式表以提高性能。

代码块主题。默认为 "system"。

• "system"：匹配当前站点模式（浅色或深色）
• "dark"：始终使用深色模式
• Shiki 主题名称字符串：将该主题应用于所有代码块
• 带有 light 和 dark 键的对象：为每种模式应用单独的 Shiki 主题

"styling": {
  "codeblocks": {
    "theme": "dracula"
  }
}

"styling": {
  "codeblocks": {
    "theme": {
      "light": "github-light",
      "dark": "github-dark"
    }
  }
}

"styling": {
  "codeblocks": {
    "languages": {
      "custom": ["/languages/my-language.json"]
    }
  }
}

缩略图的视觉主题。如果未设置，缩略图使用 colors 定义的站点配色方案。

缩略图的背景图片。可以是相对路径或绝对 URL。

缩略图的字体配置。仅支持 Google Fonts 系列名称。