De YAML-editor toont je YAML-code en de gegevens als boom naast elkaar. Vouw mappings en lijsten in, zie het type en het aantal items van elke waarde, en wijzig sleutels en waarden direct in de boom - de wijziging gaat precies op die plek in de code, en je commentaar en opmaak blijven staan. Fouten staan in een lijst met regel en kolom, van een verkeerde inspringing tot een tab of een alias zonder zijn anker, en de gegevens kunnen worden gecontroleerd aan de hand van een JSON Schema en omgezet naar JSON, CSV of XML.
Alles draait in je browser. Documenten worden niet geüpload, er is geen registratie en geen reclame.
Gekleurde YAML 1.2 links, de inklapbare boom in het midden - één boom per document na ---. Een klik in de boom springt naar de code, de cursor van de code markeert zijn waarde in de boom.
Sleutels en waarden wijzigen, items toevoegen, dupliceren, verplaatsen en verwijderen, een type wijzigen - telkens als kleine bewerking van de code, zodat commentaar en lege regels blijven waar ze zijn.
Verkeerde inspringing, tabs, dubbele sleutels, aliassen zonder hun anker en waarden die niet bij je JSON Schema passen, elk met regel en kolom.
&anchor, *alias en merge keys (<<) worden in de boom gemarkeerd en bij het omzetten opgelost.
Opmaken met consequente inspringing, of omzetten naar JSON, CSV (een lijst met mappings is een tabel) en XML. JSON-, CSV- en XML-bestanden openen als YAML.
Bewaar zoveel documenten als je wilt in je browser, elk met een eigen geschiedenis voor Ongedaan maken, en download ze allemaal als ZIP.
Elke https-pagina (en localhost) kan de editor insluiten met een <iframe> en ?embed=1 - geen registratie, geen sleutel. Ingesloten verbergt de editor deze tekst en toont hij een knop Opslaan. Er zijn twee manieren om het document erin en eruit te krijgen.
src= opent een bestand (je server moet CORS toestaan), webhook= zorgt dat "Opslaan" (Ctrl+S) het document naar dat adres stuurt. Voeg &token=… toe voor een header Authorization: Bearer … en &auto om na elke wijziging op te slaan.
<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>
De webhook krijgt een POST met JSON { editor: "yaml", event: "save", id, name, content, updated }; content is het document als tekst. Een klein PHP-script dat het opslaat:
<?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}';
De editor zegt yamleditor:ready, je pagina antwoordt met yamleditor:load, de editor meldt yamleditor:loaded, yamleditor:change bij echte bewerkingen en yamleditor:save wanneer de gebruiker opslaat. Je pagina mag yamleditor:get (de huidige toestand) of yamleditor:save (op Opslaan drukken) sturen. Opslaan loopt dan via je eigen login en sessie.
<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') { // de editor is klaar: geef hem het document
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'; // een echte bewerking
if (m.type === 'yamleditor:save') { // de gebruiker klikte op "Opslaan"
await fetch('/api/save', { method: 'POST', headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ name: m.name, content: m.content }) });
document.title = 'Saved';
}
});
// Een opslaanknop op je eigen pagina: het antwoord komt als yamleditor:save
function saveNow() { ed.contentWindow.postMessage({ type: 'yamleditor:get' }, ORIGIN); }
</script>
AI-assistent binnen je pagina: die werkt ook in het frame. Met allow="clipboard-write" op het iframe gebruikt "Prompt kopiëren" direct het klembord (anders valt de editor terug op het oude kopieercommando, of toont hij de prompt om met de hand te kopiëren). Een link die de AI stuurt, kan een editor binnen een andere website niet bereiken, dus vraagt de editor de AI en de gebruiker om in plaats daarvan het hele antwoord van de AI in de editor te plakken - of de editor in een eigen venster te openen.
window.open("https://yaml.giit.ch/?embed=window", "yamleditor-17") opent de volledige editor in een eigen venster en spreekt dezelfde berichten met window.opener. Links van een AI bereiken hem daar. yamleditor:load kan ook context: { host, title, rules } meegeven - de AI-prompt zegt dan waar het document thuishoort en volgt je regels - en hook: { url, token }, een webhook alleen voor dit document die nooit wordt opgeslagen. Als het venster met niet-opgeslagen wijzigingen wordt gesloten, stuurt het yamleditor:closing.
Geef de editor je eigen prompt, een adres op je site en een sleutel voor deze editorsessie. Het AI-venster toont dan "Verbonden met" je site, wat je de AI vertelt, en de keuze het huidige document wijzigen of een nieuw maken; Prompt kopiëren zet alles bij elkaar. De AI post het resultaat met de sleutel naar je server, en je pagina opent het in de editor - een nieuw document opent apart en blijft in de browser van de gebruiker. Eén sleutel per editorsessie: hij blijft geldig zolang de editor open is, en alleen zolang de editor er geen heeft, vraagt hij erom met yamleditor:key-request. De editor verstuurt de sleutel nooit zelf en slaat hem nooit op; het adres moet https zijn op je eigen host of een subdomein ervan.
const key = async () => (await fetch('/api/ai-key.php?doc=17')).json(); // één sleutel per editorsessie
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);
// onthoud de id uit yamleditor:loaded en negeer change/save/closing met een andere id
// alleen zolang de editor geen sleutel heeft:
if (m.type === 'yamleditor:key-request') { const k = await key(); ed.contentWindow.postMessage({ type: 'yamleditor:ai', key: k.key }, ORIGIN); }
// zolang de editor open is, meld het elke minuut aan je server; het sluiten van de editor of de pagina maakt de sleutel ongeldig
setInterval(() => fetch('/api/ai-key.php?alive=' + k.key.slice(0, 8)), 60000);
// je server heeft een resultaat (polling, SSE …): target is "current" of "new"
ed.contentWindow.postMessage({ type: 'yamleditor:load', name: 'Settings', content: draft, from: 'ai', target }, ORIGIN);
Maak sleutels met minstens 128 willekeurige bits, sla alleen hun hash op, koppel elke sleutel aan de ingelogde gebruiker, het document en deze editorsessie, maak er één per sessie, houd hem alleen geldig zolang je pagina de sessie als open meldt, en maak hem ongeldig wanneer de editor of de pagina sluit.
Het hele protocol staat in llms.txt - geef het aan een AI en die bouwt de koppeling voor je systeem. De JSON-editor werkt op dezelfde manier met het voorvoegsel jsoneditor: - json.giit.ch.
Nee. De editor draait volledig in je browser. Je documenten worden nooit naar een server gestuurd, tenzij je zelf een webhook naar je eigen server instelt.
Ja. Een wijziging in de boom wordt precies op die plek in de code geschreven; commentaar, lege regels en de rest van de opmaak blijven zoals ze zijn. Ongedaan maken draait elke wijziging terug.
YAML staat geen tabs toe voor inspringing. De editor markeert elke plek, en de Tab-toets in de code voegt spaties in.
Ja. Ankers (&name) en aliassen (*name) worden in de boom gemarkeerd, merge keys (<<) worden bij het omzetten opgelost, een alias zonder zijn anker wordt gemeld, en elk document na --- krijgt een eigen boom.
Ja, in het tabblad Omzetten of onder Exporteren. Een lijst met mappings wordt een CSV-tabel. JSON-, CSV- en XML-bestanden die je opent, worden omgezet naar YAML.
Alleen in je browser. Klik op de mapknop linksboven (Mijn documenten) om ze te openen, te hernoemen, te dupliceren, te downloaden of te verwijderen. Als je de sitegegevens van je browser wist, verdwijnen ze, dus download de documenten die je wilt bewaren - of laat de editor ze naar je eigen server sturen ("Opslaan op server").
Ja, elke AI - ChatGPT, Claude, Gemini, Copilot of de AI in je programmeertool. Klik op "AI-assistent", dan op "Prompt kopiëren", plak hem in je AI en zeg wat die moet wijzigen. De AI antwoordt met een link; klik erop en de gegevens verschijnen in je editor. "Ongedaan maken" draait elke wijziging terug.
Nee. De editor is gratis, zonder reclame en zonder registratie.