核心用法
Excalidraw Diagrams 是一项专门用于生成手绘风格图表的代码生成技能，主要服务于 Obsidian 知识库用户。该技能接收自然语言描述或结构化文本，自动输出符合 Excalidraw 规范的 JSON 数据，支持两种输出模式：
- Obsidian 模式（默认）：生成
.md文件，包含 YAML frontmatter 和 JSON 代码块，可直接被 Obsidian Excalidraw 插件识别并渲染为可编辑图表 - 标准模式：生成纯
.excalidrawJSON 文件，适用于 excalidraw.com 在线编辑器或其他标准 Excalidraw 环境
典型应用场景
- 系统架构图（微服务、云原生组件拓扑）
- 流程图与泳道图（CI/CD 流水线、审批流程）
- 思维导图与概念图谱
- 时序图与交互流程
- 矩阵图与对比分析框架
技术实现特点
技能内置完整的设计规范引擎，自动处理：
- 版式计算（20px 网格对齐、防重叠间距）
- 色彩体系（8 种语义化填充色 + 4 级文字对比色）
- 字体排印（强制 Excalifont 手写字体、14px 最小字号保障可读性）
- 箭头绑定（自动建立元素间的关联关系）
用户仅需提供内容描述，无需手动调整坐标或配色方案。
显著优点
1. 生态无缝集成：作为 Obsidian 插件的原生支持格式，生成的图表可直接嵌入双向链接的知识网络，支持本地离线编辑
2. 美学一致性：强制手绘风格（roughness=1）与统一配色，避免技术图表的冰冷感，适合演示文档与团队沟通
3. 多模态输出：同一内容可灵活切换 Obsidian 专属格式或标准格式，兼顾个人知识管理与跨平台协作
4. 结构化生成：内置 8 种图表类型模板（流程图、层级结构、关系网络等），自动选择最优布局策略
潜在局限与风险
- 格式封闭性：Obsidian 模式的 Markdown 包装语法为插件专属，脱离 Obsidian 环境后需手动提取 JSON
- 复杂布局上限：自动版式引擎擅长规则布局（树形、网格），对高度定制化或美学优先的图表仍需人工微调
- 无实时预览：生成结果为静态文件，需手动打开才能查看渲染效果，不支持即时可视化反馈
- 版本兼容性：依赖特定版本（v2）的 Excalidraw schema，若上游格式升级可能存在迁移成本
适合人群
- Obsidian 重度用户，希望将图表纳入本地知识图谱
- 技术写作者、产品经理，需要快速产出手绘风格架构图/流程图
- 注重数据主权的团队，倾向本地优先（local-first）的可视化方案
常规风险
| 风险类型 | 说明 |
|---------|------|
| 文件路径冲突 | 默认保存至 `/home/ric/Documents/Vault/0. Inbox/`，需确认该路径存在且可写 |
| 插件依赖 | Obsidian 模式要求目标环境已安装 Excalidraw 插件，否则文件无法渲染 |
| 编码规范 | 生成的 JSON 包含大量转义字符，手动编辑易破坏格式完整性 |
| 中文字体宽度 | 自动宽度估算基于 `字符数 × 字号 × 0.5`，CJK 字符需按 `×1.0` 修正，复杂排版可能溢出 |