YAML 格式化工具

YAML 格式化、校验，YAML 与 JSON 互相转换

本工具在浏览器本地运行，不会上传你的数据，保护你的隐私安全。

输入 YAML

YAML 结果

输入内容即可实时预览结果

这是什么工具？

YAML 格式化工具支持 YAML 格式化美化、语法校验和 YAML 与 JSON 双向转换。适合处理 Docker Compose、Kubernetes 配置、GitHub Actions、CI/CD 配置文件等场景。所有操作在浏览器本地完成，不上传任何数据。

如何使用？

1 粘贴 YAML 或 JSON 内容到输入框
2 选择操作：格式化、压缩、YAML 转 JSON 或 JSON 转 YAML
3 查看处理结果和语法校验提示
4 点击「复制」或「下载」保存结果

常见问题

YAML 内容会上传服务器吗？

不会，格式化和转换在浏览器本地完成。

可以 JSON 转 YAML 吗？

可以，这是重点功能之一。

YAML 错误可以提示吗？

可以，会显示解析错误原因。

适用场景与示例

编辑 Docker Compose、Kubernetes、GitHub Actions / GitLab CI 等 YAML 配置
把 JSON 配置转成 YAML，缩进式结构更易读、更易改
多环境配置切换、Helm values 调试
排查 CI/CD 流水线因 YAML 缩进或特殊字符导致的解析失败

输入

name: UPTools
version: 1
list:
  - json
  - base64

输出

同样内容，缩进对齐、结构清晰的 YAML

💡 YAML 用缩进表示层级；缩进必须一致，且只能用空格。

原理与常见错误

YAML 是「YAML Ain't Markup Language」的递归缩写，是一种用缩进表示层级的数据序列化格式，也是 JSON 的超集（任何合法 JSON 都是合法 YAML）。相比 JSON，YAML 更简洁：不需要引号和括号，还支持注释（#）、多行字符串、锚点（&）和别名（*）复用。它最大的特点是「用缩进表示嵌套」，这也带来最易踩的坑：缩进只能用空格、不能用 Tab；同一层级的缩进必须完全一致；键名后的冒号必须跟一个空格（key: value）。此外字符串里若包含 : # @ ` 等特殊字符，或看起来像数字/布尔值（如 yes/no、123），需要用引号包裹以避免被误解析。因为 YAML 语法宽松、隐式类型推断多，它比 JSON 更容易出错，CI/CD 配置里大量报错都源于缩进或特殊字符。

⚠️ 用了 Tab 缩进

YAML 禁止 Tab，缩进必须全部用空格；在编辑器里开启「Tab 转空格」。

⚠️ 同级元素缩进不一致

同一层级的缩进必须相同，差一个空格都会解析失败。

⚠️ 冒号后没有空格

key:value 不合法，必须是 key: value（冒号后有一个空格）。

⚠️ 字符串被解析成布尔值或数字

yes/no/123 等会被隐式转换，含这类值时加引号明确为字符串。

参考与更新

最后更新：2026-06-29