開発者ツール

YAML整形

YAMLを貼り付けると、きれいに整形されて戻り、間違っている行も正確に分かります。

YAML整形 お使いのデバイス上で実行
  • ブラウザ上で動作します — テキストはどこにも送信されません
  • 登録不要、利用回数の上限なし、何度でも無料で使えます

仕組み

YAMLの設計はすべてインデントに基づいていて、読みやすい反面、壊れやすいという特徴があります。不要なスペースが1つあるだけで、20分後にCIパイプラインがエラーメッセージを出します。このツールはここで解析し、すぐに教えます。

行番号つきの検証

ドキュメントが解析できない場合は、失敗した行と列、そしてパーサー自身の理由が表示されます。整形後の出力よりもこちらのほうがほぼ常に役立ち、多くの人がこの種のツールを開く理由もこれです。

再整形

有効なYAMLはデータ構造として解析され、ゼロから書き出し直されます。そのため、インデントは統一され、引用符は正規化され、余分な末尾の空白はなくなります。テキストを編集するのではなくデータを経由して往復するので、結果は有効であることが保証されます。

往復変換で失うもの

コメントは失われます。コメントはデータの一部ではないため、パーサーは破棄します。アンカーとエイリアスは保持されず、完全な値に展開されます。ファイルのコメントが重要な場合は、コピーを整形し、インデントの修正は手作業で適用してください。

キーの並べ替え

アルファベット順にすると、2つの設定ファイルをdiffで本当に比較できるようになります。一方、順序が人間の読み手にとって意味を持つファイルには不適切です。CIパイプラインは、アルファベット順より実行順のほうが読みやすくなります。

複数のドキュメント

---で区切られた複数のドキュメントを含むファイルも扱え、それぞれが順に整形されます。

よくある質問

YAML整形に関するよくある質問

コメントが消えたのはなぜですか?

整形では、YAMLをデータとして解析してから書き出し直します。コメントはデータの一部ではありません。残したい場合は、コピーを整形してください。

エラーの場所を教えてくれますか?

はい。行と列、およびパーサー自身の説明が表示されます。

YAMLはアップロードされますか?

いいえ。ブラウザ上で解析されます。YAMLに秘密情報やインフラの詳細が含まれることが多いことを考えると、これは重要です。

1つのファイルに複数のドキュメントがあっても扱えますか?

はい。---で区切られたドキュメントは、それぞれ整形されます。

キーを並べ替えるべきですか?

2つの設定ファイルを比較するときに役立ちます。順序が読み手にとって意味を持つ場合は、役に立ちません。