Python で JSON を YAML に変換
両方向の変換にそのまま使える Python コードと、出力を正しく保つためのオプション。
JSON入力
YAML出力
出力の各行を既定の書式で表示し、その行が持つ値のパスを横に示します。行をクリックするとパスをコピーできます。
すべてブラウザ内で動作し、データはアップロードされません。スパムやボットを防ぐため、公正利用の制限(入力 1 件あたり 5 MB、変換回数のレート制限)があります。
PyYAML で JSON を YAML に、そして元に戻す
PyYAML と標準の json モジュールで両方向に対応できます。次のオプションを使うと、最もきれいな出力になります。
import json
import yaml # pip install pyyaml
with open("data.json", encoding="utf-8") as f:
data = json.load(f)
with open("data.yaml", "w", encoding="utf-8") as f:
yaml.safe_dump(data, f, sort_keys=False, allow_unicode=True) import json
import yaml # pip install pyyaml
with open("data.yaml", encoding="utf-8") as f:
data = yaml.safe_load(f)
with open("data.json", "w", encoding="utf-8") as f:
# default=str turns dates and datetimes into strings
json.dump(data, f, indent=2, ensure_ascii=False, default=str) マルチドキュメント YAML と YAML 1.2
Kubernetes 形式のファイルのすべてのドキュメントを safe_load_all で読み込むか、YAML 1.2 のルールと正確なインデントが必要なら ruamel.yaml を使います。
import json
import yaml
with open("manifests.yaml", encoding="utf-8") as f:
docs = list(yaml.safe_load_all(f)) # one item per --- document
print(json.dumps(docs, indent=2, default=str)) import json
import sys
from ruamel.yaml import YAML # pip install ruamel.yaml
yaml = YAML() # round-trip mode, YAML 1.2
yaml.indent(mapping=2, sequence=4, offset=2)
with open("data.json", encoding="utf-8") as f:
yaml.dump(json.load(f), sys.stdout) Python のワンライナー
PyYAML がインストールされていれば、シェルスクリプトや CI で便利に使えます。
# JSON to YAML
python3 -c 'import sys, json, yaml; yaml.safe_dump(json.load(sys.stdin), sys.stdout, sort_keys=False, allow_unicode=True)' < data.json > data.yaml
# YAML to JSON
python3 -c 'import sys, json, yaml; json.dump(yaml.safe_load(sys.stdin), sys.stdout, indent=2, default=str)' < data.yaml > data.json よくある問題と対処法
PyYAML で変換するときに特によく出会う落とし穴です。1 つ選ぶと、修正前と修正後を確認できます。
| 症状 | 原因 | 対処法 |
|---|---|---|
| キーが並べ替えられる | safe_dump はデフォルトでキーを並べ替えます。 | sort_keys=False を渡します。 |
| é が "\xE9" になる | 非 ASCII 文字はデフォルトでエスケープされます。 | allow_unicode=True を渡します。 |
| yes / no / on / off | PyYAML は YAML 1.1 に従うため、引用符のない no は False として読み込まれます。 | YAML 内で引用符で囲むか、ruamel.yaml(YAML 1.2)を使います。 |
| TypeError: datetime is not JSON serializable | safe_load は 2026-10-01 を date オブジェクトに変換します。 | json.dump に default=str を渡します。 |
| load() に Loader がない | PyYAML 6 では yaml.load に Loader の指定が必要です。 | ファイル内のコードを決して実行しない yaml.safe_load を使います。 |
| 最初のドキュメントしか読まれない | safe_load は 1 つのドキュメントしか読みません。 | --- で区切られたファイルには safe_load_all を使います。 |
その他のツール
JSON と YAML が出会うあらゆる場面のための変換ツール、検証ツール、手順ガイド。
変換ツール
整形と検証
用途別の変換
- Kubernetes kubectl の JSON 出力や API オブジェクトを、そのまま apply できる整ったマニフェストに。
- Docker Compose ポート、環境変数、ボリュームを含む compose.yaml を JSON から作成。
- GitHub Actions on: が true になる罠を避けて、JSON からワークフローファイルを作成。
- OpenAPI / Swagger OpenAPI 3 と Swagger 2.0 の仕様を JSON と YAML の間で変換。
- CloudFormation AWS CloudFormation テンプレートを組み込み関数ごと JSON から YAML に変換。
コードとコマンドラインのガイド
よくある質問
Python で JSON を YAML に変換するには?
json.load で JSON を読み込み、PyYAML の yaml.safe_dump で書き出します:yaml.safe_dump(data, f, sort_keys=False, allow_unicode=True)。この 2 つのオプションで、キーの順序と非 ASCII 文字がそのまま保たれます。
Python で YAML を JSON に変換するには?
yaml.safe_load でファイルを読み込み、json.dump(data, f, indent=2, default=str) で書き出します。--- で区切られた複数のドキュメントを含むファイルには yaml.safe_load_all を使います。
PyYAML と ruamel.yaml のどちらを使うべきですか?
PyYAML は最も一般的な選択肢で、1 回限りの変換なら十分です。ruamel.yaml は YAML 1.2 を実装し、既存の YAML を編集するときにコメントとキーの順序を保持し、インデントもより細かく制御できます。
load ではなく safe_load を使うのはなぜですか?
フルローダーを使った yaml.load は、ファイル内のタグから任意の Python オブジェクトを生成できるため、信頼できない入力には危険です。safe_load が作るのは、dict、list、文字列、数値、真偽値、None、日付といった基本的な型だけです。
何もインストールせずに変換できますか?
はい。このページ上部のコンバーターはブラウザ内で動作し、Python もパッケージもアップロードも必要ありません。JSON か YAML を貼り付けて、結果をコピーするだけです。