YAMLを貼り付けるだけで構文エラーの行を特定。GitHub ActionsのCI設定やKubernetesマニフェストなど、 AIが生成したYAMLに起きやすいインデントミスをその場でチェックできます。
入力が空です。YAMLを入力すると出力結果が表示されます。
よくある詰まりどころチェック
構文エラー
エラーは検出されていません
タブ文字の使用
タブ文字は使用されていません
重複キー
同一階層内の重複キーはありません
インデント幅の統一
インデント幅は統一されています
行末の余分な空白
行末の余分な空白はありません
行数
1
文字数
0
サイズ
0B
ADVICE
AIが生成したYAMLは、ネストが深くなる境目（リストの後にマッピングが続く箇所など）でインデントがずれやすい傾向があります。エラーが出た場合は、まず該当行の前後で階層が切り替わっていないか確認しましょう。
YAMLのインデント崩れはなぜ起きる？AI生成コード特有の落とし穴
YAMLはインデント（字下げ）の空白数だけで階層構造を表現するフォーマットです。中括弧やカンマで区切るJSONと異なり、スペース1文字のズレがそのまま構文エラーや意図しない挙動につながります。特にGitHub ActionsのCI設定やKubernetesマニフェストのように階層が深いYAMLでは、この特性が実務上の詰まりどころになりがちです。
近年はAIにYAMLを生成・修正させる機会が増えていますが、AI生成コードはネストの深い箇所でインデントが1〜2文字分ずれる、リスト項目のあとに続くマッピングの位置が揃わないといった軽微な崩れを起こしやすい傾向があります。人間の目視だけでは見落としやすいため、貼り付けるだけで機械的にチェックできる仕組みが有効です。
本ツールはYAMLを貼り付けるだけで、構文エラーの発生行に加えてタブ文字の混入・重複キー・インデント幅の不統一まで自動でチェックし、修正すべき箇所を具体的に示します。
こんなシーンで便利です
GitHub Actions・GitLab CIの設定ファイルを書いた後の最終チェックに
CIパイプラインの設定ファイルをpushする前に、インデントミスによる実行エラーがないかを事前に確認したい場合に。エラー行がその場でわかります。
Kubernetesマニフェストを適用する前の事前検証に
kubectl applyでエラーになる前に、Deployment・Service・ConfigMapなどのマニフェストの構文とインデントを手元でチェックしたい場合に使えます。
AIに生成・修正してもらったYAMLの検算に
ChatGPTやClaudeなどAIに生成させたCI設定やマニフェストを、そのまま使う前に構文エラーがないか機械的に検証するチェックポイントとして。
チームメンバーが書いたYAMLのレビュー時に
プルリクエストでYAMLファイルの変更をレビューする際、目視だけでは気づきにくいタブ混入やインデント幅の不統一を客観的に確認する材料として活用できます。
使い方は簡単 4ステップ
- 検証したいYAMLをテキストエリアに貼り付けます（サンプルボタンから壊れた例・正常な例を読み込んで試すこともできます）。
- 入力するとリアルタイムで構文チェックが実行され、エラーがあれば該当行番号と原因が表示されます。
- 「チェック結果」パネルで、タブ混入・重複キー・インデント幅の不統一・末尾スペースの有無を確認します。
- 構文的に問題がなければ「整形」ボタンでインデントを2スペースに統一したり、「JSON変換」で構造を確認できます。
※すべての処理はブラウザ内のJavaScriptで完結し、入力したYAMLの内容が外部サーバーに送信されることはありません。
ご利用時の注意点
- 本ツールの構文チェックはYAML 1.1/1.2相当のパーサーによる解析結果に基づいています。エディタやCIツールによっては、対応するYAMLの方言（スキーマ）が若干異なる場合があります。
- 重複キーの検出はインデント幅に基づく簡易的な判定です。複雑なブロックスカラーを含むYAMLでは、検出精度が限定的になることがあります。
- 「整形」機能を使うと、YAML内に含まれていたコメント（#の行）は出力結果に反映されません。コメントを残したい場合はエラー箇所のみを手動で修正してください。
- 完全無料・安全：入力したYAMLの内容は一切送信されない、通信が発生しないブラウザ完結型を採用しています。
YAMLでよくあるエラーの原因と対処法
CI設定やKubernetesマニフェストの検証時によく遭遇するエラーメッセージと、その典型的な原因・対処法をまとめました。
| エラー・症状 | 主な原因 | 対処法 |
|---|---|---|
| bad indentation of a mapping entry | リスト項目やマッピングのキーのインデント位置が、直前の行の階層と揃っていない | 本ツールでエラー行を特定し、同じ階層の他の行とインデント幅（スペース数）を揃える |
| duplicated mapping key | 同じ階層内に同名のキー（例：steps: が2回）が存在している | 後から追加したブロックを、既存の同名キーの中にマージするか、別名に変更する |
| tab characters must not be used | インデントに全角/半角のタブ文字が混入している（エディタの自動インデント設定が原因になりやすい） | タブをすべてスペースに置換する。エディタの設定で「タブをスペースに変換」を有効にしておくと再発を防げる |
| unexpected end of the stream | 引用符（' や "）やブロックスカラー（| や >）が閉じられないまま終わっている | 該当箇所の引用符やブロックの開始位置を確認し、閉じ忘れがないか見直す |
| インデント幅が2と4で混在 | ファイル内でインデント単位（スペース数）が統一されていない | 整形ボタンで2スペース単位に統一するか、手動でインデント幅を揃える |
YAMLのインデントミスを未然に防ぐための考え方
CI/CD設定やKubernetesマニフェストでYAMLエラーを減らすための、実務的なポイントを解説します。
結論：YAMLのエラーは「貼り付けてすぐ検証」する習慣で大きく減らせる
YAMLのインデントエラーは、実際にパーサーへ読み込ませてみるまで気づきにくいという性質があります。目視でのレビューだけに頼らず、CIにpushする前・kubectl applyする前に、専用のツールで機械的に検証するステップを1つ挟むだけで、手戻りの多くを未然に防げます。
AI生成YAMLは「階層の境目」を重点的に確認する
AIが生成するYAMLのミスは、ファイル全体にランダムに発生するというより、ネストが深くなる境目（リストの中にマッピングが続く箇所など）に集中しやすい傾向があります。エラーが出た場合は、まずインデントの階層が切り替わる行を優先的に確認すると、原因を素早く特定できます。
タブとスペースの混在は「エディタ設定」で根本的に防ぐ
YAMLの仕様上、インデントにタブ文字を使うことはできません。エディタの設定で「Tabキー入力時に半角スペースへ自動変換する」オプションを有効にしておくことで、タブ混入によるエラーの発生自体を防止できます。
重複キーは「マージし忘れ」のサインであることが多い
steps: やenv: のようなキーが同じ階層に2つ存在するエラーは、多くの場合、既存の設定に追記する際に新しいブロックとして書き足してしまったことが原因です。エラーが出た際は、既存の同名キーの中に項目を追加する形に書き直すことで解決できます。
よくある失敗と対策
CIにpushしてから初めてインデントエラーに気づき、修正のやり取りに時間がかかる
ローカルで目視確認しただけでpushし、CI上で構文エラーが発生して初めて問題に気づき、修正・再push・再実行を繰り返してしまう失敗です。
💡 対策・解決策を見る▼
AIが生成したYAMLをそのまま適用し、階層のズレでリソースが意図通り作成されない
AIに生成させたKubernetesマニフェストを構文チェックせずそのまま適用し、インデントのズレによって想定していた階層構造と異なるリソースが作成されてしまう失敗です。
💡 対策・解決策を見る▼
エディタの自動インデントでタブが混入し、原因がわからないままエラーに悩まされる
コピー&ペーストや一部のエディタの自動補完によってタブ文字が混入し、エラーメッセージだけでは原因箇所が特定しづらく、修正に時間がかかってしまう失敗です。
💡 対策・解決策を見る▼
設定を追記した際に重複キーを作ってしまい、後半の設定が無視される
既存のCI設定に新しいstepsを追記する際、既存のsteps:とは別に新しいsteps:ブロックを書き足してしまい、意図した処理が実行されない失敗です。
💡 対策・解決策を見る▼
よくある質問（FAQ）
Q.このツールはどんなYAMLエラーを検出できますか
A. 構文エラー（インデントの不整合、コロンやハイフンの記法ミスなど）に加えて、YAMLの仕様上使用できないタブ文字によるインデント、同一階層内での重複キー、インデント幅の混在（2スペースと4スペースが混ざっているなど）、行末の余分な空白を検出します。エラーが見つかった場合は、該当する行番号と原因をあわせて表示します。
Q.GitHub ActionsやKubernetesのYAML以外にも使えますか
A. はい。Docker Compose、Ansible Playbook、OpenAPI（Swagger）定義など、YAML形式で書かれたファイルであれば種類を問わずご利用いただけます。CI/CD設定やコンテナ関連の構成ファイルは特にインデントミスが起きやすいため、このツールでの事前チェックが有効です。
Q.AIが生成したYAMLでよくエラーが出るのはなぜですか
A. AIによるコード生成では、ネストの深い階層で1〜2文字分インデントがずれる、リストの後に続くマッピングのインデントが揃わない、といった軽微な崩れが起きやすい傾向があります。人間の目では気づきにくい1文字のズレでも、YAMLでは構文エラーやCIパイプラインの失敗に直結するため、貼り付けてすぐに検証する使い方が特に有効です。
Q.整形（フォーマット）機能では何が行われますか
A. 構文的に有効なYAMLに対して、インデント幅を2スペースに統一した形で再出力します。ただし整形処理の性質上、元のYAMLに含まれていたコメント（#で始まる行）は整形後の結果には反映されません。コメントを保持したい場合は、エラー箇所のみを手動で修正することをおすすめします。
Q.入力したYAMLの内容が外部に送信されることはありませんか
A. ありません。本ツールはすべての解析・検証処理をブラウザ内のJavaScriptのみで実行しており、入力内容がサーバーに送信されることは一切ありません。APIキーやKubernetesのSecret情報を含む設定ファイルでも、通信が発生しないため安心してご利用いただけます。
Q.重複キーの検出はどのくらい正確ですか
A. 同一インデント階層内でのキー重複を、行のインデント幅をもとに簡易的に検出しています。多くのCI設定やマニフェストで問題なく機能しますが、複雑なブロックスカラー（|や>で始まる複数行の文字列）を含む場合など、一部のケースでは検出精度が限定的になることがあります。最終的な正しさは構文チェック結果とあわせてご確認ください。
あなたの声で、
このツールをより鋭く。
「こんな機能が欲しい」「ここを直してほしい」といったご意見や、新しいツールのリクエストを募集しています。エンジニアが直接目を通し、開発の参考にさせていただきます。