跳转到主要内容
使用 docs.json 中的这些设置来控制文档站点的视觉标识——布局主题、品牌颜色、logo、字体和背景。

​
设置

​
theme - 必填

站点的布局主题。 可选值：mint、maple、palm、willow、linden、almond、aspen、sequoia、luma。 查看 主题 了解预览和详情。

​
name - 必填

类型： string 项目、组织或产品的名称。显示在浏览器标签页标题和站点的其他位置。

​
colors - 必填

类型： object 文档中使用的颜色。颜色在不同主题中的表现有所不同。如果只提供主色，它将应用于所有颜色元素。
​
colors.primary
string
必填
文档的主色。通常在浅色模式下用于强调，具体因主题而异。必须是以 # 开头的十六进制代码。示例："#0D9373"。
​
colors.light
string
深色模式下用于强调的颜色。必须是以 # 开头的十六进制代码。
​
colors.dark
string
在浅色和深色模式下用于按钮和悬停状态的颜色，具体因主题而异。必须是以 # 开头的十六进制代码。
docs.json
"colors": {
  "primary": "#0D9373",
  "light": "#55D799",
  "dark": "#0D9373"
}
类型： string 或 object 站点 logo。可提供单个图片路径或为浅色和深色模式分别提供图片。
​
logo.light
string
必填
浅色模式的 logo 文件路径。包含文件扩展名。示例：/logo/light.svg。
​
logo.dark
string
必填
深色模式的 logo 文件路径。包含文件扩展名。示例：/logo/dark.svg。
​
logo.href
string (uri)
点击 logo 时跳转的 URL。如果未提供，对于国际化文档，logo 链接到当前所选语言的第一个页面；对于单语言站点，链接到首页。示例：https://yoursite.com。
docs.json
"logo": {
  "light": "/logo/light.svg",
  "dark": "/logo/dark.svg",
  "href": "https://yoursite.com"
}

​
favicon

类型： string 或 object favicon 文件路径，包含文件扩展名。会自动调整为适当的 favicon 尺寸。可提供单个文件或为浅色和深色模式分别提供文件。
​
favicon.light
string
必填
浅色模式的 favicon 路径。包含文件扩展名。示例：/favicon.png。
​
favicon.dark
string
必填
深色模式的 favicon 路径。包含文件扩展名。示例：/favicon-dark.png。
docs.json
"favicon": "/favicon.svg"

​
appearance

类型： object 浅色/深色模式设置。
​
appearance.default
"system" | "light" | "dark"
默认颜色模式。选择 system 以匹配用户的操作系统设置，或选择 light 或 dark 强制使用特定模式。默认为 system。
​
appearance.strict
boolean
设为 true 时，隐藏浅色/深色模式切换，用户无法切换模式。默认为 false。
docs.json
"appearance": {
  "default": "dark",
  "strict": true
}

​
fonts

类型： object 文档的自定义字体。默认字体因主题而异。支持 Google Fonts 和自托管字体。
​
fonts.family
string
必填
字体系列名称，如 "Inter" 或 "Open Sans"。支持 Google Fonts 字体系列名称——这些会自动加载，无需 source。
​
fonts.weight
number
字重，如 400 或 700。可变字体支持小数字重，如 550。
​
fonts.source
string (uri)
托管字体的 URL 或本地字体文件的路径。Google Fonts 不需要此项。
  • 托管：https://example.com/fonts/MyFont.woff2
  • 本地：/fonts/MyFont.woff2
​
fonts.format
"woff" | "woff2"
字体文件格式。使用 source 字段时必填。
​
fonts.heading
object
仅覆盖标题的字体设置。接受与顶级 fonts 对象相同的 family、weight、source 和 format 字段。
​
fonts.body
object
仅覆盖正文文本的字体设置。接受与顶级 fonts 对象相同的 family、weight、source 和 format 字段。
docs.json
"fonts": {
  "family": "Inter",
  "heading": {
    "family": "Playfair Display"
  }
}

​
icons

类型： object 图标库设置。每个项目只能使用一个图标库。文档中的所有图标名称必须来自所选库。
​
icons.library
"fontawesome" | "lucide" | "tabler"
必填
整个文档使用的图标库。默认为 fontawesome。
无论库设置如何，你都可以为任何单个图标指定外部托管图标的 URL 或项目中图标文件的路径。
docs.json
"icons": {
  "library": "lucide"
}

​
background

类型： object 背景图片、装饰和颜色设置。
​
background.decoration
"gradient" | "grid" | "windows"
主题的装饰背景图案。
​
background.color
object
浅色和深色模式的自定义背景颜色。
​
background.image
string or object
站点的背景图片。可提供单个路径或为浅色和深色模式分别提供路径。
docs.json
"background": {
  "decoration": "gradient",
  "color": {
    "light": "#F8FAFC",
    "dark": "#0F172A"
  }
}

​
styling

类型： object 精细的视觉样式控制。
​
styling.eyebrows
"section" | "breadcrumbs"
页面眉标（显示在页面顶部的标签）的样式。选择 section 显示章节名称，或选择 breadcrumbs 显示完整导航路径。默认为 section。
​
styling.latex
boolean
控制是否加载 LaTeX 样式表。默认情况下，Mintlify 会自动检测内容中的 LaTeX 使用并加载必要的样式表。
  • 设为 true 以在自动检测失败时强制加载 LaTeX 样式表。
  • 设为 false 以防止加载 LaTeX 样式表，如果不使用数学表达式可以提升性能。
​
styling.codeblocks
"system" | "dark" | string | object
代码块主题。默认为 "system"。
  • "system"：匹配当前站点模式（浅色或深色）
  • "dark"：始终使用深色模式
  • Shiki 主题 名称字符串：将该主题应用于所有代码块
  • 包含 light 和 dark 键的对象：为每种模式应用不同的 Shiki 主题

​
thumbnails

类型： object 社交媒体和页面预览的缩略图自定义。
​
thumbnails.appearance
"light" | "dark"
缩略图的视觉主题。如果未设置，缩略图使用 colors 定义的站点配色方案。
​
thumbnails.background
string
缩略图的背景图片。可以是相对路径或绝对 URL。
​
thumbnails.fonts
object
缩略图的字体配置。仅支持 Google Fonts 字体系列名称。

​
示例

docs.json
{
  "$schema": "https://mintlify.com/docs.json",
  "theme": "maple",
  "name": "Example Co.",
  "colors": {
    "primary": "#3B82F6",
    "light": "#93C5FD",
    "dark": "#1D4ED8"
  },
  "logo": {
    "light": "/logo/light.svg",
    "dark": "/logo/dark.svg",
    "href": "https://example.com"
  },
  "favicon": "/favicon.svg",
  "appearance": {
    "default": "system"
  },
  "fonts": {
    "family": "Inter"
  },
  "icons": {
    "library": "lucide"
  },
  "background": {
    "decoration": "gradient"
  }
}