Code
YAML エディターは、YAML コードとツリー表示のデータを並べて表示します。マッピングとリストを折りたたみ、各値の型と項目数を確認し、ツリーで直接キーと値を変更できます。変更はコードのちょうどその位置に書き込まれ、コメントと書式は残ります。エラーは、誤ったインデントからタブ、アンカーのないエイリアスまで行と列付きで一覧表示され、データを JSON Schema で検証したり、JSON、CSV、XML に変換したりできます。
すべてブラウザー内で動作します。ドキュメントはアップロードされず、登録も広告もありません。
左側にハイライト付きの YAML 1.2、中央に折りたためるツリー (--- の後のドキュメントごとに 1 つのツリー)。ツリーをクリックするとコードへ移動し、コードのカーソル位置の値がツリーで示されます。
キーと値の変更、項目の追加、複製、移動、削除、型の変更。それぞれがコードへの小さな編集なので、コメントと空行はそのまま残ります。
誤ったインデント、タブ、重複したキー、アンカーのないエイリアス、JSON Schema に適合しない値を、それぞれ行と列付きで示します。
&anchor、*alias、マージキー (<<) はツリーで示され、変換時には解決されます。
一貫したインデントで整形、または JSON、CSV (マッピングのリストは表になります)、XML に変換。JSON、CSV、XML ファイルは YAML として開きます。
ドキュメントをいくつでもブラウザー内に保管でき、それぞれに元に戻す履歴があり、すべてを ZIP でダウンロードできます。
https のページ (および localhost) なら、<iframe> と ?embed=1 でエディターを埋め込めます。登録もキーも不要です。埋め込まれたエディターはこの説明文を隠し、保存ボタンを表示します。ドキュメントを受け渡す方法は 2 つあります。
src= でファイルを開き (サーバーで CORS の許可が必要)、webhook= を指定すると「保存」(Ctrl+S) でドキュメントがそのアドレスに送信されます。&token=… を付けると Authorization: Bearer … ヘッダーが付き、&auto を付けると変更のたびに保存します。
<iframe src="https://yaml.giit.ch/?embed=1&src=https://your-site.com/config/app.yaml&webhook=https://your-site.com/save.php"
allow="clipboard-write" style="width:100%;height:800px;border:0"></iframe>Webhook は JSON { editor: "yaml", event: "save", id, name, content, updated } を含む POST を受け取ります。content はドキュメントの文字列です。それを保存する小さな PHP スクリプト:
<?php
header('Access-Control-Allow-Origin: https://yaml.giit.ch');
header('Access-Control-Allow-Headers: Content-Type, Authorization');
header('Access-Control-Allow-Methods: POST, OPTIONS');
if ($_SERVER['REQUEST_METHOD'] === 'OPTIONS') exit;
if (($_SERVER['HTTP_AUTHORIZATION'] ?? '') !== 'Bearer SECRET') { http_response_code(403); exit; }
$d = json_decode(file_get_contents('php://input'), true);
$name = preg_replace('/[^\w\- ]/u', '_', $d['name']);
file_put_contents(__DIR__ . "/config/$name.yaml", $d['content']);
echo '{"ok":true}';エディターが yamleditor:ready を送り、ページが yamleditor:load で応答すると、エディターは yamleditor:loaded を返し、実際に編集されると yamleditor:change、ユーザーが保存すると yamleditor:save を送ります。ページからは yamleditor:get (現在の状態) や yamleditor:save (保存ボタンを押す) を送れます。保存はあなた自身のログインとセッションを通して行われます。
<iframe id="ed" src="https://yaml.giit.ch/?embed=1" allow="clipboard-write" style="width:100%;height:800px;border:0"></iframe>
<script>
const ed = document.getElementById('ed');
const ORIGIN = 'https://yaml.giit.ch';
addEventListener('message', async e => {
if (e.source !== ed.contentWindow || e.origin !== ORIGIN) return;
const m = e.data;
if (m.type === 'yamleditor:ready') { // エディターの準備完了: ドキュメントを渡す
ed.contentWindow.postMessage({
type: 'yamleditor:load',
name: 'Settings',
content: await (await fetch('/config/app.yaml')).text()
}, ORIGIN);
}
if (m.type === 'yamleditor:change') document.title = '● not saved'; // 実際の編集
if (m.type === 'yamleditor:save') { // ユーザーが「保存」をクリックした
await fetch('/api/save', { method: 'POST', headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ name: m.name, content: m.content }) });
document.title = 'Saved';
}
});
// 自分のページの保存ボタン: 応答は yamleditor:save として届く
function saveNow() { ed.contentWindow.postMessage({ type: 'yamleditor:get' }, ORIGIN); }
</script>ページ内の AI アシスタント: フレーム内でも動作します。iframe に allow="clipboard-write" を付けると、「プロンプトをコピー」がクリップボードを直接使います (付けない場合は古いコピーコマンドを使うか、手動でコピーできるようプロンプトを表示します)。AI が送るリンクはほかの Web サイト内のエディターには届かないため、エディターは AI とユーザーに、代わりに AI の回答全体をエディターに貼り付けるよう案内します。または、エディターを専用のウィンドウで開いてください。
window.open("https://yaml.giit.ch/?embed=window", "yamleditor-17") は完全なエディターを専用のウィンドウで開き、window.opener と同じメッセージをやり取りします。AI からのリンクもそこに届きます。yamleditor:load には context: { host, title, rules } (AI プロンプトがドキュメントの所属先を伝え、あなたのルールに従います) と hook: { url, token } (このドキュメント専用で保存されない Webhook) も含められます。未保存の変更があるままウィンドウを閉じると yamleditor:closing が送られます。
エディターに独自のプロンプト、サイト上のアドレス、このエディターセッション用のキーを渡します。すると AI ダイアログには、あなたのサイトへの「接続先」、AI に伝える内容、そして 現在のドキュメントを変更 か 新しいドキュメントを作成 の選択肢が表示され、プロンプトをコピー ですべてがまとめられます。AI はキーを付けて結果をあなたのサーバーに送り、ページがそれをエディターで開きます。新しいドキュメントは別に開き、ユーザーのブラウザー内に残ります。キーはエディターセッションごとに 1 つです。エディターを開いている間は有効で、キーがないときだけエディターが yamleditor:key-request で要求します。エディターがキーを自分で送ったり保存したりすることはありません。アドレスはあなた自身のホストまたはそのサブドメイン上の https である必要があります。
const key = async () => (await fetch('/api/ai-key.php?doc=17')).json(); // エディターセッションごとにキーを 1 つ
const k = await key();
ed.contentWindow.postMessage({ type: 'yamleditor:load', name: 'Settings', content, ai: {
label: 'My Site', prompt: 'Keep every key and every comment.',
endpoint: 'https://your-site.com/api/ai-result.php', key: k.key } }, ORIGIN);
// yamleditor:loaded の id を覚えておき、別の id の change/save/closing は無視する
// エディターにキーがないときだけ:
if (m.type === 'yamleditor:key-request') { const k = await key(); ed.contentWindow.postMessage({ type: 'yamleditor:ai', key: k.key }, ORIGIN); }
// エディターを開いている間、毎分サーバーに知らせる。エディターまたはページを閉じるとキーは無効になる
setInterval(() => fetch('/api/ai-key.php?alive=' + k.key.slice(0, 8)), 60000);
// サーバーに結果がある (ポーリング、SSE …): target は "current" または "new"
ed.contentWindow.postMessage({ type: 'yamleditor:load', name: 'Settings', content: draft, from: 'ai', target }, ORIGIN);キーは 128 ビット以上のランダム値で作り、ハッシュだけを保存し、それぞれをログイン中のユーザー、ドキュメント、このエディターセッションに結び付けてください。キーはセッションごとに 1 つ作り、ページがセッションを開いていると報告している間だけ有効にし、エディターまたはページが閉じたら無効にしてください。
プロトコルの全体は llms.txt にあります。AI に渡せば、あなたのシステム用の接続を作ってくれます。JSON エディターも接頭辞 jsoneditor: で同じように動作します - json.giit.ch。
いいえ。エディターは完全にブラウザー内で動作します。自分で自分のサーバーへの Webhook を設定しない限り、ドキュメントがサーバーに送られることはありません。
はい。ツリーでの変更はコードのちょうどその位置に書き込まれ、コメント、空行、そのほかの書式はそのまま残ります。「元に戻す」ですべての変更を戻せます。
YAML ではインデントにタブを使えません。エディターはそのすべての箇所に印を付け、コード内の Tab キーではスペースが入力されます。
はい。アンカー (&name) とエイリアス (*name) はツリーで示され、マージキー (<<) は変換時に解決され、アンカーのないエイリアスは報告され、--- の後の各ドキュメントには専用のツリーがあります。
はい、変換 タブまたはエクスポートでできます。マッピングのリストは CSV の表になります。開いた JSON、CSV、XML ファイルは YAML に変換されます。
ブラウザー内だけです。左上のフォルダーボタン (マイドキュメント) をクリックすると、開く、名前の変更、複製、ダウンロード、削除ができます。ブラウザーのサイトデータを消去すると削除されるので、残したいものはダウンロードするか、エディターから自分のサーバーに送ってください (「サーバーに保存」)。
はい、どの AI でも使えます。ChatGPT、Claude、Gemini、Copilot、またはコーディングツールの AI です。「AI アシスタント」、続いて「プロンプトをコピー」をクリックし、AI に貼り付けて何を変更するか伝えてください。AI はリンクで回答します。クリックするとデータがエディターに表示されます。「元に戻す」ですべての変更を戻せます。
いいえ。エディターは無料で、広告も登録もありません。