このツールの動作
YAML は JSON の上位集合なので、対応は素直です。オブジェクトはマッピングに、配列はシーケンスになり、各スカラーは型を保ちます。
{ "name": "Ada", "tags": ["math", "engine"], "active": true }
name: Ada
tags:
- math
- engine
active: true
意味が変わるところは引用する
{ "country": "NO", "flag": "yes", "at": "12:30" }
country: "NO"
flag: "yes"
at: "12:30"
素のまま書けば、この三つは YAML 1.1 の解析器に偽、真、750 と読まれます。1.1 を実装するのは PyYAML であり、世界の非常に多くが YAML を読むのに使っているのがその PyYAML です。国コードが繰り返し真偽値になってしまうことから、ノルウェー問題と呼ばれます。
ここでは値が JSON から文字列として届くので、それが何かに曖昧さはありません。引用することが、どの読み手にとっても文字列のまま保つ唯一の書き方です。本物の真偽値は素のままです。true は true のままです。
長い識別子は桁を保つ
{ "id": 12345678901234567890 }
は二十桁のまま出ます。多くの変換器はまず JSON を JavaScript の値へ解析するので、すべての数値が倍精度浮動小数点を通り、十五桁ほどを超えると黙って丸められます。ここでは数値をそれが実際にそうであるところの文字列として読みます。
複数行の文字列はブロックスカラーになる
改行を含む文字列は、\n ではなく YAML の読みやすいブロック形式で書きます。
description: |-
一行目
二行目
渡らないもの
コメントとアンカーです。JSON にはどちらもないので、運ぶものがありません。それらを足すと称する変換器は、あなたのファイルの注釈を捏造することになります。それは人の仕事です。
プライバシー
すべての処理はブラウザ内のJavaScriptだけで完結します。データがアップロードされることはないため、機密情報でも安心して利用でき、オフラインでも動作します。