DiagramPreview
2026-10-246 分钟

Markdown 设计规范模板:在线预览、修改与下载

下载完整的工作区设置设计规范,在 Markdown 预览工具中修改,复用设计变量、组件状态、响应式规则和验收清单。

Markdown 设计规范模板:在线预览、修改与下载
01

有用的规范,要把决策写清楚

截图可以展示一个按钮,却无法完整解释何时禁用、请求期间如何变化,以及失败后是否保留用户草稿。好的规范让这些决策对设计师、开发者和 AI 助手都清晰可见。

这份 DiagramPreview 独立模板描述工作区设置表单。它使用普通 Markdown,可以适配代码仓库、评审文档或 Figma Specs 工作流。它不是 Figma 官方模板、自动导入格式,也不承诺在不同编辑器中呈现完全一致。

02

打开、修改或下载完整示例

点击打开模板,即可把下方同一份源文档载入现有 Markdown 编辑器。修改项目名称、交互和设计规则后,检查标题、列表与验收清单的预览效果。下载按钮提供完全相同的源文档。

预览链接把示例文字放在网址片段中。之后如果分享带有自己修改内容的链接,收到链接的人就可以读取其中的源文档。分享前请去掉项目私密信息。

需要按项目填写规则时,可以打开规范生成器,分别填写目标、设计变量、组件状态和验收清单,再编辑、预览与下载 Markdown。运行完整性检查,可查看状态、具名变量、键盘行为、响应式约束和验收条目的原文依据或补充建议。可另行修改 Mermaid 示例并打开现有工具导出 SVG/PNG;文字命中不代表实现正确。

markdown可复制示例
# 工作区设置 — 设计规范

> DiagramPreview 独立示例,请按产品实际情况调整;这不是 Figma 官方模板或导入格式。

## 目标与范围
让工作区所有者修改工作区名称与通知偏好。
不包含:账单、成员邀请和权限管理。
预览使用虚构数据,本示例不接入生产后台。

## 设计变量
- 主要操作:#1D4ED8,搭配白色文字。
- 正文:#0F172A,背景 #FFFFFF。
- 次要文字:#475569;错误文字:#B91C1C。
- 字体:system-ui;正文 16px / 24px;标题 24px / 32px。
- 间距:4、8、12、16、24、32px;卡片圆角:8px。
- 使用有名称的设计变量,不临时添加任意颜色或间距。

## 组件与状态
### 保存按钮
- 默认:文案「保存更改」,使用主要操作背景。
- 悬停:背景 #1E40AF,保持白色文字清晰可读。
- 焦点:显示 2px 轮廓,与按钮间隔 2px。
- 禁用:内容未变化或校验不通过;在输入框旁说明错误。
- 加载:文案「保存中…」,防止重复提交。
- 成功:通过 live region 宣告「更改已保存」。
- 失败:显示行内错误并允许重试,保留编辑内容。

### 工作区名称
- 必填,去除首尾空白后长度为 2–60 个字符。
- 始终展示标签与辅助说明;占位符不能替代标签。
- 失焦和提交前进行校验;错误信息与输入框建立关联。
- 校验失败时不保存任何修改。

## 交互与数据
1. 加载当前名称与通知偏好。
2. 允许修改;仅在内容有效且发生变化时启用保存。
3. 提交后模拟请求,在请求期间展示加载状态。
4. 成功后保留确认的值,并宣告操作完成。
5. 失败后保留草稿,提供重试操作。
- 初始加载:展示带文字说明的加载占位。
- 初始请求失败:展示重试操作,不虚构已保存的数据。
- 服务端返回空名称:在保存前显示必填提示。

## 响应式布局
- 小于 768px:单列,页面边距 16px,保存按钮占满宽度。
- 768px 及以上:表单居中,最大宽度 640px,边距 24px。
- 320px 视口宽度下:页面不出现水平滚动。

## 无障碍
- 每个输入框有可被程序识别的标签;Tab 顺序与视觉顺序一致。
- 所有交互均可使用键盘完成,并有可见焦点。
- 成功和错误使用文字说明,不仅靠颜色传达。
- 检查普通文字与实际背景的对比度不低于 4.5:1。

## 验收清单
- [ ] 空名称与纯空白名称不能提交。
- [ ] 长度不在 2–60 个字符之间时显示明确错误。
- [ ] 保存期间重复点击只发起一次请求。
- [ ] 保存失败后保留编辑内容,并可以重试。
- [ ] 保存成功会宣告完成,不强行移动焦点。
- [ ] 通过键盘操作与 320px 移动端检查。
- [ ] 实现的每一种状态均符合本规范。

## 上线前待确认
- 与研发确认真实接口、授权规则与错误响应。
- 与产品负责人确认通知行为与最终文案。
- 数据契约确认后再替换模拟请求。
工作区设置完整示例,包含设计变量、组件状态、响应式规则和验收清单。
03

如何改成自己的项目规范

先替换业务范围。账单表单、邀请流程和通知设置的权限与失败路径并不相同。删除不适用的状态,并补充真实流程需要的状态。

再把颜色、字体和间距替换为已有的设计变量,同时说明各变量的用途。单独一个十六进制色值,并不能告诉实现者它应该用于背景、边框还是错误提示。

将待确认事项与已批准规则分开。示例把生产接口和授权契约留给研发确认;助手遇到缺口应指出问题,而不是自行编造后台行为。

04

给 AI 一条范围明确的实现请求

附上修改后的规范与相关设计稿或组件资料,一次请求实现一个页面,并明确范围。下面的提示词可以复用,不依赖特定 AI 厂商。

text可复制示例
依据附带规范,实现工作区设置原型。
复用有名称的设计变量与现有组件。
实现默认、加载、成功、失败和禁用状态。
仅使用虚构数据与模拟请求。
列出待确认事项,不编造接口或授权规则。
逐项报告验收条件:已演示、缺失或需人工检查。
让规范与小型原型逐项对应的提示词示例。
05

按验收清单核对实际结果

亲自执行无效输入、重复提交、网络失败与成功路径,将观察到的结果对应到每个验收项。生成的检查报告可以辅助评审,但不能代替原型真正运行后的证据。

除正常流程外,还要检查键盘焦点和窄屏布局。记录观察到什么、在哪个环境检查,以及哪些决策仍未确定。把规范放在实现附近,后续修改也能按同一套规则评审。

06

流程复杂时,再添加图表

单个表单用编号步骤通常已经足够。审批分支或跨服务交互比较复杂时,可以另加流程图或时序图,并从规范中链接过去。

DiagramPreview 的 Markdown 工作流支持 Mermaid,但这不代表 Figma Specs 原生支持 Mermaid。交付到 Figma 时,需要确认适用的嵌入或图片方式,同时单独保留图表源码以便后续修改。