1440×900 · 390×844
https://mintlify.com

首屏结构、分享卡片与基础配置

标题层级与首屏入口高信息密度
H1×1 · H2×9
H1
H2
H2
H3
H3
H3
H3
首屏主动作Get started
Next.jsTailwindlang=en

正文

714

操作候选

11

内/外链

69/14

HTML

443 KB

分享预览与标题长度og:image ✓

mintlify.com

Mintlify - The documentation platform for agents

Self-updating documentation for startups, enterprises, and agents.

标题字数48 字 · 理想区间
摘要字数66 字 · 理想区间
响应头与资源构成3/6
HTTPS
HSTS
CSP
nosniff
Viewport
JSON-LD
脚本65 ext · 89 inl
图片 Alt 覆盖率10/34 (29%)
第三方域8 个域名

好设计,具体好在哪

薄荷绿只做克制的品牌点缀

全页大面积维持 #ffffff 白底与 #08090a 深墨文字,绿色只出现在品牌徽标、柔和背景光线与文档高亮态。

文档实景直接展示目录、正文与 AI 问答

访客一眼就能看到用 Mintlify 生成出来的文档长什么样,比任何文字夸赞都直接。

最值得先改的几件事

  1. 01

    收敛首屏并列的三个相近起步动作

    首屏同时摆放 Get started、Sign up with Google 与 Set up with agents 三种近似起点,视线略分散。

    明确一个主按钮视觉重心,将 CLI/Agent 初始化命令收纳为轻量可复制代码条,核对手机端纵向间距。

配色、字体排印与代码变量

浅色底 · 翠绿 / 薄荷正文对比度 19.9:1 AAA
点击任意色块直接复制 HEX
mintlify.com

arizonaFlare

+ inter

ABCDEFGHIJKLMNOPQRSTUVWXYZ · 0123456789

白底清透空间、薄荷绿极光弧线与真实的文档目录预览,把原本枯燥的开发文档做出了清新的现代感。

字阶比例

50px / 16px

标题约为正文 3.13×

阅读节奏

行高 24px

字重 400 · 字距 -2px

圆角轮廓

4px按钮
/* Extracted design tokens from mintlify.com via VibeCheck */
:root {
  --color-bg: #ffffff;
  --color-surface: #ecf4f4;
  --color-ink: #08090a;
  --color-accent: #18b888;
  --color-muted: #cccccc;
  --font-display: "arizonaFlare", system-ui, -apple-system, "PingFang SC", "Noto Sans SC", sans-serif;
  --font-body: "inter", system-ui, -apple-system, "PingFang SC", "Noto Sans SC", sans-serif;
  --text-h1: 50px;
  --text-body: 16px;
  --leading-body: 24px;
  --tracking-display: -2px;
  --radius-button: 4px;
  --space-section: 0px;

  /* Source custom properties sample */
  --blur-lg: 16px;
  --blur-md: 12px;
  --text-lg: 1.125rem;
  --text-sm: .875rem;
  --text-xs: .75rem;
  --grid-gap: 16px;
  --text-3xl: 1.875rem;
  --c15t-text: var(--color-foreground-primary);
}

参数来自页面元素采样,空值表示未取得;不将单个元素的参数当作全站规范。

逐项依据

收敛首屏并列的三个相近起步动作

转化

首屏同时摆放 Get started、Sign up with Google 与 Set up with agents 三种近似起点,视线略分散。

→ 明确一个主按钮视觉重心,将 CLI/Agent 初始化命令收纳为轻量可复制代码条,核对手机端纵向间距。

desktop.png: Get started, Sign up with Google and Set up with agents stacked in hero

没有 Content-Security-Policy

上线

CSP 是限制脚本源的标准做法。vibe 页面常常什么都加载,包括被注入的脚本。

→ 先开 report-only CSP,再收成 default-src 'self' 和明确的 script-src。

content-security-policy missing

没有 X-Content-Type-Options

上线

没有 nosniff,浏览器可能按错误类型解释文件。这是一行响应头。

→ 设置 X-Content-Type-Options: nosniff。

x-content-type-options missing

没有 Referrer-Policy

上线

默认 referrer 可能把站内路径和查询串漏给第三方。

→ 设置 Referrer-Policy: strict-origin-when-cross-origin。

referrer-policy missing

直接复制给你的 AI Agent

按需切换修复当前页、做同款参考、导出 DESIGN.md 或保存为项目级 SKILL.md。

粘贴到 Claude Code / Cursor 对话框查看全局品味规范 →
请基于 https://mintlify.com 的 2026-11-11T06:49:26.277Z 页面快照优化当前项目。先确认当前实现与快照差异,不要把已变化的内容重新改回旧版。

设计基线
#ffffff 画布左对齐 arizonaFlare 50px 标题、Google 快捷注册入口与“Set up with agents”命令提示,右下方托起完整的三栏文档工作台截图。
{
  "colors": [
    {
      "role": "bg",
      "hex": "#ffffff"
    },
    {
      "role": "surface",
      "hex": "#ecf4f4"
    },
    {
      "role": "ink",
      "hex": "#08090a"
    },
    {
      "role": "accent",
      "hex": "#18b888"
    },
    {
      "role": "muted",
      "hex": "#cccccc"
    }
  ],
  "fonts": {
    "body": "inter",
    "display": "arizonaFlare",
    "stack": [
      "inter",
      "arizonaFlare",
      "paperMono"
    ]
  },
  "radius": {
    "button": "4px",
    "card": "",
    "field": ""
  },
  "space": {
    "section": "0px",
    "card": ""
  },
  "type": {
    "h1": "50px",
    "body": "16px",
    "weight": "400",
    "lineHeight": "24px",
    "letterSpacing": "-2px"
  }
}
数据来自同次页面采集;字体、圆角和间距为具体元素采样,不代表全站唯一设计规范。空值为未取得。HTML 为源码体积,不是压缩传输量;脚本数为 DOM 标签数,不是请求数。

执行事项
1. 收敛首屏并列的三个相近起步动作
明确一个主按钮视觉重心,将 CLI/Agent 初始化命令收纳为轻量可复制代码条,核对手机端纵向间距。
依据: desktop.png: Get started, Sign up with Google and Set up with agents stacked in hero

2. 没有 Content-Security-Policy
先开 report-only CSP,再收成 default-src 'self' 和明确的 script-src。
依据: content-security-policy missing

3. 没有 X-Content-Type-Options
设置 X-Content-Type-Options: nosniff。
依据: x-content-type-options missing

4. 没有 Referrer-Policy
设置 Referrer-Policy: strict-origin-when-cross-origin。
依据: referrer-policy missing

验收
- 在 1440×900 和 390×844 分别核对文字、布局和主要操作“Get started”。
- 保留已有品牌、登录和业务链路,不从静态截图推断交互故障。
- 只修复有证据的项;涉及安全响应头时先用报告模式验证现有资源及认证兼容性。
- 对比修改前后的截图,并执行相关功能测试。不要声称未经测试的功能已通过。
全部气质库 →