Convertor PRO — Tipps & Tricks

Zurück zur Übersicht: Convertor PRO · Tool live öffnen: www.jpkc.com/tools/convertor/

Das Manual erklärt jedes Feld, die Beispiele zeigen die Arbeitsabläufe. Hier geht es um das, was beides voraussetzt, aber selten dabeisteht: wo die echten Stolperfallen liegen, wann eine Konvertierung verlustbehaftet ist und wie du Convertor PRO mit anderen Werkzeugen kombinierst. Die Oberfläche ist auf Englisch — die echten Tab- und Knopf-Namen stehen deshalb im Original.

Daten-Formate: was eine Konvertierung verliert

Der wichtigste mentale Schritt: Jede Format-Konvertierung läuft über eine gemeinsame Daten-Zwischenstufe (ein JavaScript-Objekt). Was dieses Objekt nicht abbilden kann, geht verloren — egal in welcher Richtung.

Kommentare überleben nie. YAML-, TOML-, INI- und XML-Kommentare sind nach der Konvertierung weg. Wenn dir Kommentare wichtig sind, konvertiere früh und kommentiere danach im Zielformat — nicht umgekehrt.
Reihenfolge und Formatierung sind nicht garantiert. Du bekommst eine kanonische, sauber eingerückte Ausgabe, nicht dein Original-Layout. Für einen Diff gegen die Quelle ist das ungünstig; zum Aufräumen ist es ideal.
Strings bleiben, Zahlen und Struktur nicht immer. Strings wie 0755, +49 oder yes werden nicht heimlich zu Zahlen oder Booleans, und aus JSON kommen auch 20-stellige IDs und 1.0 ziffergenau heraus (außer in Listen, die INI als JSON-String schreibt). Ziffergenau ist aber nur der Weg aus JSON heraus: Liest das Tool YAML, werden große Ganzzahlen gerundet und aus 1.0 wird 1 — ohne Hinweis. JSON → YAML → JSON ist für solche Zahlen also kein sauberer Round-Trip; heb das JSON-Original auf. Sobald XML (mit seiner @attr/#text-Übersetzung) oder INI (mit seiner flachen Struktur) im Spiel ist, kann das Rückergebnis strukturell abweichen. Plane solche Konvertierungen als Einbahnstraße, nicht als hin und zurück.

Die gelbe Hinweis-Box ernst nehmen

Wo ein Zielformat etwas nicht abbilden kann, passt das Tool die Daten an — und sagt es dir unter den Editoren in der Box „Not everything fits the target format:", mit Pfad zur Stelle. Typisch: null fällt in TOML weg, inf/nan werden in JSON zu null, eine zu große Ganzzahl wird in TOML zum String, ein Schlüssel mit Leerzeichen wird in XML zu <a_b>. Lies die Box, bevor du die Ausgabe weiterverwendest. Eine leere Box ist allerdings kein Freibrief: Ohne Hinweis bleiben Kommentare und Formatierung, die Punkt-Notation für tiefe Objekte in INI, die Hülle <root> in XML, Zahlen aus YAML- und TOML-Quellen, die Nachkomma-Null von 1.10 aus JSON und Datumswerte aus TOML, die zu Zeichenfolgen werden. Die ganze Liste steht im Manual.

Fehlerzeile direkt anspringen

Lässt sich die Eingabe nicht lesen, nennt die rote Fehlermeldung meist Zeile und Spalte — und der Knopf Go to line … setzt den Cursor genau dorthin. Bei einer langen YAML- oder JSON-Datei ist das schneller als jedes Suchen. Steht die Quelle auf Auto-detect und kein Parser nimmt die Eingabe an, bekommst du nur „The format was not recognized"; stell dann das erwartete Format links von Hand ein, um die genaue Fehlermeldung dieses Parsers zu sehen.

INI ist die engste Form — dorthin zuletzt

INI hat das schwächste Datenmodell der fünf Formate: nur eine Sektionsebene, keine verschachtelten Listen. Konvertierst du etwas Verschachteltes nach INI, werden tiefe Objekte ohne Hinweis mit Punkt-Notation (db.host = …) flachgeklopft, Listen einfacher Werte zu key[] = …-Zeilen, und Listen, die Objekte oder Listen enthalten, landen als JSON-String im Wert. Beim Zurücklesen bleibt die Punkt-Notation ein flacher Schlüssel. Praktische Regel: INI nur als Ziel, wenn die Daten von Natur aus flach sind. Für alles Strukturreiche sind JSON, YAML oder TOML die ehrlicheren Ziele. Details in den Grenzen im Manual.

Auto-detect rät nicht nach Mustern, sondern parst die Eingabe probeweise: XML, JSON, TOML, YAML, INI — strenge Formate zuerst. Das Abzeichen neben Source zeigt, was erkannt wurde. Grenzfälle gibt es trotzdem, weil manche Texte in mehreren Formaten gültig sind: [server] mit port = 8080 ist gültiges TOML und gültiges INI und wird als TOML erkannt. Für port ist das egal, für Werte wie size = 1e3 oder mask = 0x10 nicht: TOML liest sie als Zahlen 1000 und 16, INI lässt sie als Strings "1e3" und "0x10" stehen. Faustregel: Wirf einen Blick aufs Abzeichen, und stell das Format bei Zweifeln von Hand ein.

Achtung beim Wechsel zwischen Dateien: Open file stellt bei eindeutiger Endung (.json, .toml, …) das Source-Format fest ein. Fügst du danach etwas anderes ein, bleibt diese Einstellung stehen — stell dann wieder auf Auto-detect zurück.

Encoding: Keep ASCII als „nur das Exotische"-Schalter

Im Encoding-Tab ist die Checkbox Keep ASCII der nützlichste, am häufigsten übersehene Schalter. Sie sitzt an den Feldern Hexadecimal NCRs, Decimal NCRs, Unicode U+hex und 0x... notation (nicht am HTML/XML-Feld) und ist dort standardmäßig an. Mit ihr bleiben normale ASCII-Zeichen lesbar stehen und nur die „besonderen" Zeichen werden umgesetzt. Beispiel Feld Hexadecimal NCRs, Eingabe Über: Mit Keep ASCII wird nur das Nicht-ASCII-Ü zur Hex-NCR — Ergebnis Über, die ASCII-Buchstaben ber bleiben stehen. Schaltest du die Checkbox ab, werden auch die ASCII-Zeichen zu NCRs (Über) — eine Wand aus Entities, die du fast nie willst. Brauchst du wirklich jedes Zeichen escaped (etwa für ein striktes ASCII-Transport-Format), ist genau das der richtige Modus. Mit Keep Latin-1 bleiben zusätzlich Umlaute, ß und é stehen.

Wundere dich nicht, wenn im Feld Unicode U+hex trotz Keep ASCII einzelne Buchstaben umgesetzt werden: Aus Über wird dort U+00DC U+0062 U+0065r. Ein b oder e direkt hinter U+00DC würde beim Zurücklesen als weitere Hex-Ziffer gelten — das Tool schreibt solche Zeichen deshalb als Notation, damit die Umwandlung verlustfrei bleibt.

Mixed input ist der Universal-Entschlüssler

Wenn du Text aus unbekannter Quelle hast, in dem mehrere Escape-Arten durcheinander vorkommen — ein paar &#x…;, ein %C3%BC, ein \u00E9 —, dann tippe ihn nicht mühsam in einzelne Felder. Wirf ihn in Mixed input: Das Feld erkennt die verschiedenen Notationen in einem Durchgang und liefert den Klartext. Zwei Dinge solltest du dabei im Kopf haben:

Backslashes: Mit ausgeschalteter Checkbox Decode \n, \t, \xHH bleiben Pfade wie C:\temp heil — aber nur, wenn kein Pfadteil nach dem Backslash mit 0–9 oder a–f beginnt: Aus C:\data wird C:Úta, weil \da als CSS-Escape gilt. Für JavaScript- oder JSON-Strings mit \n und \t schaltest du sie ein.
Hex CP, Dec CP, UTF-8, UTF-16 lösen zusätzlich nackte Zahlen auf. Das ist ideal für Hexdumps und Code-Point-Listen, aber nur dort: Wörter, die nur aus den Buchstaben A–F bestehen (Add, bad, cafe), sind für Hex CP auch Hexzahlen und werden mit dekodiert. Für Fließtext mit eingestreuten Escapes nimmst du Convert.

Surrogate-Paare und Emojis korrekt verstehen

Bei Zeichen jenseits der Basic Multilingual Plane (Emojis, viele Symbole, seltene Schriften) lohnt der Blick auf UTF-16 code units: Dort siehst du das Surrogate-Paar, mit dem solche Zeichen in JavaScript und UTF-16 intern dargestellt werden. Wenn ein String in JS „eine falsche Länge" hat oder ein Emoji beim Abschneiden zerbricht, ist das fast immer ein Surrogate-Problem — Convertor PRO macht es sichtbar.

Nichts verlässt deinen Rechner

Convertor PRO ist rein clientseitig — kein Upload, kein Server-Roundtrip, keine Speicherung. Das ist nicht nur schnell, sondern auch der Grund, warum du Konfigurationen mit Secrets, Tokens oder internen Hostnamen bedenkenlos konvertieren kannst: Die Daten bleiben im Browser-Tab. (Trotzdem gilt: Ausgaben, die du kopierst oder herunterlädst, behandelst du wie das sensible Original.)

Kombination mit anderen JPKCom-Tools

Convertor PRO klärt Encoding und Format — für das, was davor oder danach kommt, helfen die Nachbarn aus der Code-&-Text-Familie:

JSON-Editor — wenn du nach der Konvertierung tiefer mit der JSON-Struktur arbeiten willst: validieren, durchsuchen, gezielt editieren. Convertor PRO bringt dich ins JSON, der JSON-Editor arbeitet darin.
Coder — für Encoding-Operationen jenseits der Zeichen-Umwandlung: Base64, Punycode, Quoted-Printable, JWT und Data-URIs. Wo Convertor PRO bei Zeichen-Repräsentationen aufhört, macht Coder weiter.
Hash — wenn du aus einem Text keine andere Schreibweise, sondern eine Prüfsumme oder einen Passwort-Hash brauchst.