DiagramPreview
基础解析YAML树形查看配置

YAML to Diagram

粘贴 YAML，并把配置层级查看成结构化树状图。

示例
YAML 树就绪
你的 YAML 树会显示在这里。

下一步可以继续

把当前预览结果带到相关工具里继续转换、排查或导出。

SQL 转 ER 图

从 CREATE TABLE SQL 生成 ER 图，检查表、主键、外键和关系。

打开
JSON Schema 可视化

查看 JSON Schema 属性、类型、必填字段、枚举、数组 item 和 oneOf/anyOf 结构。

打开
JSON Schema 表单预览

把 JSON Schema 的属性、必填项、枚举和格式转换成表单预览。

打开

使用方法

  1. 1把 YAML 粘贴到编辑器。
  2. 2检查生成层级。
  3. 3通过语法错误修复缩进或非法值。

常见场景

CI 配置复核Kubernetes YAML 检查文档示例

相关工具

SQL 转 ER 图

从 CREATE TABLE SQL 生成 ER 图，检查表、主键、外键和关系。

JSON Schema 可视化

查看 JSON Schema 属性、类型、必填字段、枚举、数组 item 和 oneOf/anyOf 结构。

JSON Schema 表单预览

把 JSON Schema 的属性、必填项、枚举和格式转换成表单预览。

常见问题

YAML 和 JSON 图表共用逻辑吗？

是的，YAML 会先解析成数据，再走同一套 tree model 可视化。

YAML to Diagram 会把嵌套配置文件转成结构化树，让层级更容易阅读。

它适合 CI workflow、Kubernetes manifest、静态站点配置和文档示例，因为这些内容非常依赖缩进。

该工具和 JSON to Diagram 共享树状可视化逻辑，后续改进可以同时惠及两种数据格式。

Demo：把 workflow YAML 预览成树

YAML 缩进容易写，也容易读错。树形预览能检查 jobs、steps、环境变量和嵌套配置是否在正确父节点下。

  • 仔细检查 steps、containers、rules、hosts 下的数组。
  • 从文档复制片段后先预览。
  • 多文档 YAML 尽量逐个文档 review。
name: CI
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm test

调试：缩进就是 YAML 的结构

很多 YAML 问题不是解析错误，而是合法 YAML 放错层级。预览应让这种静默结构错误更明显。

  • 值没生效时先看同级 key 是否正确。
  • 避免 tab 和混合缩进。
  • Kubernetes 先确认 metadata、spec、template 层级。
spec:
  template:
    spec:
      containers:
        - name: api
          image: ghcr.io/acme/api:latest

YAML to Diagram 检查清单

当你需要在文档、PR、故障复盘或交接材料发布前检查源码内容时，可以使用 YAML to Diagram。把 YAML 文档可视化成可读的树状图。

导出前建议检查标签是否可读、关系是否和源码一致、示例是否包含敏感信息，以及修改输入后预览是否仍然成立。

限制与排查

如果预览失败，先把输入缩小到最小完整示例，确认格式语法，再逐段加回内容。很多失败来自不完整文件、缩进错误、缺少图表头，或复制了依赖隐藏上下文的片段。

请把预览结果当作 review 界面，而不是生产事实来源。生成的图表、转换文件、看板和规则示例在进入正式文档或运维流程前仍需要人工确认。

可测试的示例输入

  • Workflow: name: preview steps: - install - build - verify
  • Kubernetes: apiVersion: v1 kind: Service metadata: name: diagram-preview spec: ports: - port: 80
  • 配置: site: name: DiagramPreview locales: - en - zh-CN exports: svg: true png: true

工具完成度

基础解析

基础解析

这个工具偏向快速结构检查，适合预览、排查和定位问题；关键输出进入生产前仍需要人工复核。

分级不是质量打分，而是告诉用户当前工具更适合稳定导出、深度调试、快速解析，还是 AI 辅助生成。