YAML ↔ TOML

关于本工具

YAML 与 TOML 配置文件互转工具，基于 eemeli/yaml + smol-toml。常用于在 Hugo / Zola / 部分 Cargo 项目（用 TOML）和 Kubernetes / GitHub Actions（用 YAML）之间迁移配置；TOML 顶层必须是表（key-value），数组或标量会被拒绝转换。

什么时候用

• 把 Hugo / Zola TOML 配置转 YAML 给 GitHub Actions 用
• Cargo.toml / pyproject.toml 风格配置改写 YAML 版本
• 在 K8s YAML manifest 与某些用 TOML 的 IaC 工具间迁移
• 学习两种格式的差异——粘贴一份看互译结果

隐私说明

本工具完全在浏览器内运行，输入的数据从不上传到任何服务器，关闭页面即清除。可以在浏览器开发者工具的 Network 面板自行验证：使用过程中无任何向 toolkit.best 的网络请求。

常见问题

支持 TOML 1.0 吗？

支持。基于 smol-toml v1.x，符合 TOML 1.0 spec。

为什么 YAML → TOML 报顶层不是表？

TOML 规范要求顶层是 key-value 表（{ ... }），不允许数组（[ ... ]）或标量。把 YAML 顶层包一层 key 即可，例如 'items:' + 缩进数组。

注释会保留吗？

不会。两种格式都支持注释，但中间 AST 没有保留——序列化输出是干净的。

TOML 的内联表 / 数组表怎么处理？

smol-toml 解析两种语法都支持。反向 YAML → TOML 时，嵌套对象默认输出为标准表（[section] 风格）而非内联表。

为什么不用 @iarna/toml？

smol-toml 体积更小（~10KB minified）、TOML 1.0 全兼容、活跃维护；@iarna 自 2020 后停更。

最近更新：2026-05-07