01
确认默认导出全部文档
示例包含多份文档，初始选择为全部文档。选择编号后只输出那一份资源，输入仍保留完整内容；需要整份配置时再切回全部。示例和清空会先预览将替换的原文行数，点应用才更改，撤销可同时恢复上一次输入和结果。
YAML / TOML / ENV 配置
YAML 格式化整理缩进，也留住配置说明
切换缩进、检查结构与引用，再选择需要导出的文档。
YAML 格式化
YAML 输入
格式化结果
内容仅在当前浏览器处理，YAML 不会上传。
结果已过期，暂时无法导出。
用 YAML 格式化整理多人修改过的配置时，缩进统一只是第一件事。注释解释了参数的来源，锚点说明哪些地方共用设置，长数字也可能是不能改动的标识；这些信息应该留在审阅视野里。
这里的 YAML 美化结果始终放在独立面板中，输入原文不会被替换。对于一个文件里的多份资源，先检查整个文档流，再明确选择导出范围，避免只拿到第一份而误以为处理了全部。
为什么使用这个 YAML 格式化工具
排版改变，配置说明仍可核对
通过文档节点重新输出，保留注释、锚点名称和数字原始写法，不经过会丢失注释的 JSON 中转。结果独立显示，便于比较层级和说明；空白与字符串表现形式仍可能被规范化。
从完整文档流中明确挑选资源
YAML 格式化会先检查每一份文档。选择单份资源时，其他文档的语法错误仍会阻断导出；切回全部文档即可保留整个配置流，不会静默省略未选中的错误。
先看范围，再看结果状态
02
长段编辑时关闭自动执行
自动模式会在停止输入约 350 毫秒后刷新。关闭开关才会显示格式化按钮，也可按 Ctrl/Cmd+Enter 执行。改动输入或选项后，旧结果立即停止提供复制和下载。
03
区分源位置与输出视图
结构和锚点视图显示的是原输入中的行号与文档编号。无论当前正在看哪个摘要，复制和下载的内容都是所选范围的 YAML，不是摘要列表。
看清层级、数值与引用关系
两种缩进宽度
YAML 缩进可统一为每级 2 个或 4 个空格，映射和序列的顺序保留。切换宽度只生成新结果，不会覆盖左侧输入；块字符串仍按标量处理，里面的脚本不会执行。
重复键不会用后值覆盖
YAML 校验检查整个流，而非只看选中的那一份。标量键按 Core 语义判断重复，包括不同数字写法指向同一个键的情况。发现冲突后停止输出，并给出原文位置，由你决定保留哪项。
保留数字原始文本
长整数、长小数与科学计数法从原始数字片段写回，不先经过浏览器浮点数舍入。非有限数也保持 YAML 表示。下游软件仍可能按自己的数字类型读取，因此数值保留不等于接收端也具备相同精度。
只读查看结构与锚点
摘要列出映射、序列和标量的类型、所在文档与原文行号。引用视图展示锚点声明及别名目标，每次增加 50 项。不会递归展开引用，因此查看自引用时也不会复制出无穷多层内容。
支持范围与处理预算
- 固定使用 1.2 Core
- 不加引号的 yes、no、on、off 按字符串处理，其他版本指令和不支持的标签会报错。映射键可用字符串、数字、布尔值或空值标量；集合键和别名键不在本版支持范围内。
- 引用只属于当前文档
- 有效别名保留名称而不展开，自引用也只作为引用保留。未定义或跨文档的别名报错。<< 在这里是普通 Core 键，不会触发合并，也不会继承另一个映射的字段。
- 校验不能代替配置语义审查
- 任意文档有语法错误或重复键，均不给导出。不猜测修复缩进、不排序、不压缩，也不转换为其他格式；Kubernetes 或 CI 的字段规则需另行校验。保留注释与数字不表示输出逐字节不变。
- 超限报错，不截断下载
- 输入最多 500000 个字符、100 份文档、100 层深度、50000 个节点，输出最多 2000000 个字符。任何预算超限都停止处理；请在本地按实际文档边界拆分，别把缺了一段的输出当成完整配置。
YAML 格式化常见问题
用制表符给 YAML 缩进会发生什么？
缩进中的制表符通常使文档无法解析。这里不会猜测一个制表符应该代表几格，而是提示错误位置。先用编辑器将其改成符合预期层级的空格，再执行 YAML 格式化；改变输出缩进选项并不能修复无法解析的原文。
锚点与别名能保留下来吗？
可以。锚点与别名仍以引用形式出现在结果中，还能在只读视图中查看声明和目标位置。引用必须在同一文档内指向先前的锚点；未定义或跨文档引用会报错，不会被偷偷展开或替换。
为什么 no 有时会变成布尔值？
这是 YAML 版本差异导致的常见问题。部分 1.1 解析器把 no 当作布尔值，而本工具固定使用 1.2 Core，将其作为字符串。接收配置的软件如果使用不同版本，需要另外确认；也可在源文中明确给字符串加引号。
一个文件含多份 YAML 文档时怎么处理？
初始导出全部文档，也可选择某一份单独下载。所有文档都要先通过语法和重复键检查，其他文档出错也会阻断当前选择。分隔符定义的资源边界保留，锚点不会跨过这些边界引用。
格式化和转换能代替 Kubernetes 配置校验吗？
不能。这里检查文本能否按支持的 YAML 语义解析，不验证资源字段、必填参数或部署环境。用 YAML 格式化看清层级后，还需要运行 Kubernetes、Docker Compose 或对应 CI 平台的校验。
遇到处理不正确的配置？