大家好,我是何三,独立开发者

design_md_cover

做前端开发的同学应该都有过这种经历:老板甩过来一个设计稿,说"照着这个做"。你打开 Figma,看着那些精妙的间距、恰到好处的圆角、舒服到骨子里的配色,然后开始一个个量、一个个抄。

累不累?累。但更累的是——你根本不知道为什么它好看。

今天介绍一个 GitHub 项目,叫 awesome-design-md,已经拿到了 12k Star,它做的事情很直接:把 55 个顶级网站的设计规范,全部整理成了 Markdown 文件。

不是截图,不是 Figma 链接,是实打实的代码级规范——颜色 HEX 值、字号、字重、阴影参数、间距系统,全给你列好了。

直接复制到项目里,AI Agent 就能读懂。

DESIGN.md 是个什么概念?

这个项目背后的核心概念叫 DESIGN.md,最早由 Google Stitch 提出。

简单说,它就是一份纯文本的设计规范文档,AI Agent 能直接读取并据此生成 UI。

design_md_01

你可能觉得这也没什么稀奇的,设计规范文档谁不会写?

关键区别在于:DESIGN.md 是写给 AI 看的

传统的 Figma 设计稿、设计 Token JSON,AI 读起来很费劲。但 Markdown?那可是大语言模型最熟悉的格式。丢一个 DESIGN.md 进项目根目录,任何 AI 编码工具(Cursor、Windsurf、Google Stitch)都能立刻理解你的 UI 应该长什么样。

不需要 Figma 导出,不需要 JSON Schema,不需要任何特殊工具。一个 Markdown 文件就搞定了。

这 55 个设计规范有多细?

我随便翻了几个,精度吓人。

Linear 为例,它的 DESIGN.md 里有这样的细节:

  • 主背景色不是纯黑,是 #08090a,带一点极其微弱的蓝冷调
  • 文字不是纯白,是 #f7f8f8,防止在深色背景上刺眼
  • 标题用的 Inter Variable 字体,但开启了 cv01ss03 两个 OpenType 特性,让字形变得更几何、更干净
  • 字号 72px 时,letter-spacing 是 -1.584px——负的,把字往里压,制造紧凑感
  • 品牌色只有一个:#5e6ad2(靛蓝紫),整个网站除了灰度色系就只有这一个彩色

再看看 Vercel

  • 用的是自家 Geist 字体,48px 标题的 letter-spacing 压到 -2.4px-2.88px
  • 不用 CSS border,全靠 box-shadow: 0px 0px 0px 1px rgba(0,0,0,0.08) 模拟边框线。这套"影子当边框"的技巧贯穿了整个设计系统
  • 阴影不是单层的,是多层叠加——一层当边框、一层做抬升、一层做环境光、一层做内发光,四个值堆在一起

Notion 的有趣之处在于它用的是暖灰色系:

  • 灰色不是冷灰,是带黄棕底色的暖灰:#f6f5f4(暖白)、#31302e(暖深)
  • 文字用 rgba(0,0,0,0.95),95% 不透明度的黑——比纯黑柔和,但差距小到你以为就是黑色
  • 阴影每层的不透明度不超过 0.05,五层叠加起来才有自然感

这些规范是从真实网站的 CSS 里提取出来的,不是人工拍脑袋写的。

design_md_02

每个 DESIGN.md 里都有什么?

每个文件统一遵循 9 大模块的结构:

design_md_03

1. Visual Theme & Atmosphere — 整体风格描述,用自然语言讲清楚这个网站的"气质"。比如 Linear 被描述为"黑暗中的星光",Vercel 是"被压缩的基础设施"。

2. Color Palette & Roles — 完整色板,每种颜色都有语义角色标注(主文字、次文字、品牌色、悬停态……)和精确的 HEX/RGBA 值。

3. Typography Rules — 字体族、字重、字号、行高、字间距的完整层级表。从 72px 的 Display 到 10px 的 Micro,每一个级别都有精确参数。

4. Component Stylings — 按钮、卡片、输入框、徽章、导航,每个组件的每种状态(默认、悬停、聚焦、禁用)都有详细样式。

5. Layout Principles — 间距系统、栅格参数、留白哲学。比如 Linear 用 8px 基准间距,但偶尔会出现 7px 和 11px 的微调值——那是为了视觉对齐做的光学补偿。

6. Depth & Elevation — 阴影层级系统。从 Level 0(无阴影)到 Level 5(对话框),每层的具体参数都有。

7. Do's and Don'ts — 设计禁区。比如 Linear 明确写了"不要用 700 粗体,最大只到 590"、"不要给深色背景用实心彩色按钮,透明度才是王道"。

8. Responsive Behavior — 响应式断点、触控区域大小、折叠策略。

9. Agent Prompt Guide — 直接给 AI 用的提示词模板。比如"帮我创建一个 Linear 风格的 Hero 区域,背景色 #08090a,标题 48px Inter Variable weight 510……"

最后一个模块是点睛之笔。它意味着你甚至不需要自己去解读这些规范,直接把提示词喂给 AI 就行。

实际怎么用?

用法极其简单,两步:

第一步,从项目仓库里找到你喜欢的网站,复制它的 DESIGN.md 到你的项目根目录。

仓库地址:https://github.com/VoltAgent/awesome-design-md

# 比如你想用 Linear 的设计规范
cp design-md/linear.app/DESIGN.md ./your-project/

第二步,在 AI 编码工具里告诉它:"按照 DESIGN.md 的规范,帮我做一个 XX 页面。"

然后看着 AI 帮你把 Linear 的设计语言搬到你的项目里。

每个网站还附带了 preview.htmlpreview-dark.html,是可视化的设计元素目录——色块、字号层级、按钮样式、卡片效果,一目了然。

这项目为什么值得关注?

我聊几个我观察到的点。

第一,它解决了一个真实痛点。 AI 编码工具(Cursor、Windsurf 等)越来越强,但它们生成的前端页面经常"能用但不好看"。原因很简单——AI 不知道你要什么风格。DESIGN.md 就是给 AI 一个明确的设计"说明书"。

第二,它降低了设计门槛。 不是每个人都有设计师搭档。有了这些规范,独立开发者可以直接"抄"顶级公司的设计语言。不是简单复制粘贴,而是拿到一套经过验证的设计系统——从颜色到间距到阴影,全套的。

第三,它在推动一种新的协作方式。 以前设计师出 Figma,前端照着做。以后可能是设计师出 DESIGN.md,AI 直接生成代码。中间那个"人工翻译"的环节,可能要被干掉了。

第四,MIT 开源协议,随便用。 不过项目也说了,这些是从公开网站的 CSS 里提取的设计参数,不代表他们拥有任何网站的视觉版权。

还有个细节

项目里有些 DESIGN.md 的描述写得像散文。

比如 Linear 的主题描述里写了这么一句:

"Linear's website is a masterclass in dark-mode-first product design — a near-black canvas where content emerges from darkness like starlight."

Vercel 的:

"The custom Geist font family is the crown jewel. Geist Sans uses aggressive negative letter-spacing, creating headlines that feel compressed, urgent, and engineered — like code that's been minified for production."

Notion 的:

"Notion's website embodies the philosophy of the tool itself: a blank canvas that gets out of your way."

这些描述不是给人类设计师看的,是给 AI 看的。AI 读懂这些自然语言描述后,生成的 UI 才会有"感觉",而不只是像素级还原。

这个思路挺有意思的——用自然语言的"设计意图"去引导 AI 的"设计决策"。

最后

如果你对前端设计感兴趣,或者正在用 AI 编码工具做项目,强烈建议去翻翻这个仓库。就算不直接用,光看这些顶级网站的设计规范拆解,也能学到不少东西。

地址放这了:https://github.com/VoltAgent/awesome-design-md

12k Star,MIT 协议,55 个网站的设计规范,全免费。

本文使用 MGO 编辑并发布

关注"何三笔记",回复"mgo" 免费下载使用