JSONL → YAML 変換ツール

JSONL(JSON Lines)をすぐに YAML 形式に変換できます。JSONL データを貼り付けるか直接入力するか、ファイルをアップロードしてください。

JSONL 入力

.jsonl ファイルをここにドロップするか、クリックしてファイルを選択してください

.jsonl、.ndjson、.json、.txt ファイルに対応

YAML 出力

変換結果の YAML がここに表示されます...

JSONL から YAML への変換とは?

JSONL(JSON Lines)と YAML は、どちらも広く使われているデータのシリアライズ形式です。JSONL は1行に1つの JSON オブジェクトを格納する形式で、ストリーミングや機械処理に最適化されています。YAML はインデントで構造を表す、人が読みやすい構文を採用しており、設定ファイルによく使われます。

JSONL から YAML への変換は、機械処理向けのデータを、人が読み書きしやすい形式にしたい場合に役立ちます。JSONL の各レコードは、それぞれ独立した YAML ドキュメントになり、ドキュメント区切りの --- で区切られます。

同じデータを並べて比較

JSONL と YAML は用途が異なります。JSONL は改行で区切ったデータを機械間でやり取りするために、YAML は人が設定を編集するために使われます。同じデータ構造を両方の構文で見比べると、変換のルールがよくわかります。

概念JSONLYAML
1 レコード{"name": "api", "port": 8080}name: api / port: 8080(それぞれ別の行)
複数レコード1 行に 1 レコード--- マーカーでドキュメントを区切る
ネスト波括弧:{"db": {"host": "..."}}インデントのみ。空白で構造を表します
コメント非対応(JSON の仕様)# コメント — 設定ファイルで YAML が好まれる主な理由

JSONL を YAML に変換する方法

入力欄に JSONL データを貼り付けるか、.jsonl ファイルをアップロードします。各行には有効な JSON オブジェクトを記述してください。

各行の JSON を自動で解析し、YAML 形式に変換します。JSONL の各レコードは、それぞれ独立した YAML ドキュメントになり、--- で区切られます。

変換結果の YAML をクリップボードにコピーするか、.yaml ファイルとしてダウンロードします。元の JSONL のデータ構造やネストはすべて保持されます。

YAML への変換で気を付けたい落とし穴

ノルウェー問題

{"country": "no", "available": "yes"}

YAML 1.1 では、引用符のない no はブール値の false、yes は true として解析されます。ノルウェーの国コードがブール値に化けてしまう、よく知られた問題です。この変換ツールは、別の型に解釈される可能性がある文字列(yes/no/on/off/y/n など)を必ず引用符で囲み、相互に変換してもデータが保持されるようにします。出力を手作業で編集する場合も、引用符は残してください。

数値や日付に見える文字列

{"version": "1.10", "built": "2024-03-05"}

引用符のない 1.10 は浮動小数点数の 1.1 になり、引用符のない日付は、ローダーによってはタイムスタンプオブジェクトとして解析される場合があります。これを防ぐため、出力ではどちらも引用符で囲みます。JSONL で文字列だった値は、元に戻したときも文字列である必要があります。

主な用途

Kubernetes の設定
JSONL 形式でエクスポートしたデータを、Kubernetes のマニフェストや Helm チャートの values ファイルで使える YAML 形式に変換します。
Docker Compose ファイル
JSONL で記述したサービス定義を、コンテナオーケストレーションに使う docker-compose.yml 形式に変換します。
CI/CD パイプラインの設定
JSONL 形式のパイプラインデータを、GitHub Actions、GitLab CI、CircleCI の設定ファイルで使える YAML 形式に変換します。
設定管理
JSONL 形式の構造化データを、Ansible の Playbook、Terraform の設定、アプリケーションの設定に使う YAML 形式に変換します。
API ドキュメント
JSONL 形式の API エンドポイントデータを、OpenAPI/Swagger の仕様ファイルで使える YAML 形式に変換します。
データの可視化
JSONL のデータセットを YAML に変換し、YAML 入力を推奨するデータ可視化ツールやレポートシステムで利用します。

変換時によくあるエラー

JSONL の各行の構文エラー

入力する JSONL の各行は、有効な JSON オブジェクトである必要があります。よくある原因は、末尾の余分なカンマ、引用符で囲まれていないキー、閉じ括弧の抜けなどです。変換前に、このサイトの JSONL バリデーターで検証してください。

バイナリデータや UTF-8 以外のデータ

YAML には UTF-8 でエンコードされたテキストデータが必要です。JSONL にバイナリデータや UTF-8 以外の文字が含まれていると、変換に失敗したり、意図しない結果になったりする場合があります。入力データが正しくエンコードされていることを確認してください。

YAML の特殊文字

JSON の値には、YAML で特別な意味を持つ文字(コロン、ハッシュ記号、先頭のダッシュなど)が含まれることがあります。この変換ツールは、必要に応じて自動で引用符を付けたりエスケープしたりして、有効な YAML を出力します。

よくある質問

JSONL から YAML への変換とは何ですか?

JSONL から YAML への変換では、JSON Lines データ(1行に1つの JSON オブジェクト)を YAML 形式に変換します。JSONL の各レコードは、それぞれ独立した YAML ドキュメントになり、ドキュメント区切りの --- で区切られます。YAML はインデントで構造を表す構文で、JSON よりも人が読みやすい形式です。

複数の JSONL レコードは、YAML ではどのように表現されますか?

出力ファイルでは、JSONL の各レコードがそれぞれ独立した YAML ドキュメントになります。ドキュメントは、単独の行に記述された ---(3つのダッシュ)で区切られます。これは、YAML で複数のドキュメントを区切る標準的な記法です。

変換後もデータ型は保持されますか?

はい。JSON のすべてのデータ型(文字列、数値、ブール値、null、配列、オブジェクト)は、それぞれに対応する YAML の型に正しく変換されます。ネストした構造や配列も、YAML の適切なインデントで保持されます。

大容量の JSONL ファイルも YAML に変換できますか?

はい。このツールはストリーミング処理により、大容量ファイルの変換にも対応しています。1MB を超えるファイルは、全体をメモリに読み込まずにストリーミングで処理するため、効率よく変換できます。

出力される YAML はどのような形式ですか?

出力には、2スペースのインデントを使った標準の YAML 構文を使用します。JSONL の各レコードは、--- で区切られた YAML ドキュメントになります。文字列には必要な場合にのみ引用符を付け、複雑な構造には適切な YAML のブロック記法を使います。

設定ファイルには JSONL より YAML のほうが適していますか?

YAML は人が読みやすく、コメントも使えるため、設定ファイルによく選ばれます。JSONL はデータのストリーミングや機械処理に向いています。設定には YAML を、データ交換には JSONL を使ってください。

逆に YAML から JSONL へ変換することもできますか?

はい。このサイトの YAML → JSONL 変換ツールで、YAML ドキュメントを JSONL 形式に戻せます。--- で区切られた各 YAML ドキュメントが、出力では1行の JSON になります。

ネストされたオブジェクトも変換できますか?

はい。深くネストした JSON オブジェクトや配列にも対応しています。すべての階層を再帰的に処理し、YAML の適切なインデントで出力します。

関連ツールとガイド