Eine CSV-Datei aus Excel, einem CRM oder einer Datenbank-Exportfunktion ist schnell erstellt, doch viele Programmierschnittstellen, JavaScript-Anwendungen und NoSQL-Datenbanken erwarten JSON. Die gute Nachricht: Die Umwandlung dauert wenige Sekunden, und mit dem Converter auf dieser Seite passiert sie vollstaendig in Ihrem Browser, ohne Upload und ohne Anmeldung. Diese Anleitung zeigt jeden Schritt, erklaert die wichtigsten Optionen und geht auf die typischen Stolperfallen ein, vom deutschen Semikolon bis zur Datentyp-Erkennung.
In fuenf Schritten von CSV zu JSON
Der schnellste Weg fuehrt direkt ueber das Tool auf der Startseite. Der gesamte Ablauf besteht aus fuenf Schritten, die unten im Detail erklaert werden. Wer es eilig hat, fuegt einfach seine Daten ein und prueft die Standardeinstellungen.
Schritt 1: CSV-Daten einfuegen oder Datei laden
Oeffnen Sie die CSV in einem Texteditor oder direkt aus Excel und kopieren Sie den Inhalt in das Eingabefeld des Converters. Alternativ laesst sich eine .csv- oder .txt-Datei direkt laden. Wichtig ist nur, dass die erste Zeile in der Regel die Spaltennamen enthaelt, also die spaeteren Schluessel im JSON. Wer kein Beispiel zur Hand hat, kann mit der Funktion Beispiel laden sofort sehen, wie eine korrekte CSV aussieht.
Schritt 2: Das richtige Trennzeichen waehlen
CSV steht fuer Comma-Separated Values, doch in der Praxis ist das Komma laengst nicht das einzige Trennzeichen. Deutsche Excel-Exporte nutzen fast immer das Semikolon, weil das Komma hierzulande als Dezimaltrennzeichen dient. Daneben sind Tabulator (oft als TSV bezeichnet) und der senkrechte Strich (Pipe) verbreitet. Stellen Sie das Trennzeichen passend ein, sonst landet die gesamte Zeile in einem einzigen Feld.
Schritt 3: Header-Zeile und Datentypen festlegen
Ist die Option fuer die Header-Zeile aktiv, wird die erste Zeile als Quelle fuer die Objektschluessel verwendet. Ohne diese Option erhalten die Felder generische Schluessel wie column1, column2 und so weiter. Zusaetzlich entscheiden Sie, ob Werte automatisch typisiert werden: Soll aus dem Text 42 die Zahl 42 werden und aus true der boolesche Wert true? Fuer Rechenwerte ist das praktisch, fuer Identifikatoren mit fuehrenden Nullen sollten Sie die Typ-Erkennung dagegen abschalten.
Schritt 4: Ausgabeformat bestimmen
Hier waehlen Sie zwischen Array, Keyed und Nested. Welches Format das richtige ist, haengt davon ab, was das Zielsystem erwartet. Eine REST-Schnittstelle moechte meist ein Array von Objekten, ein Lookup nach ID profitiert vom Keyed-Format, und verschachtelte Strukturen entstehen aus Punkt-Notation im Header. Die Unterschiede zeigt der naechste Abschnitt im Detail.
Schritt 5: Ergebnis kopieren oder herunterladen
Das JSON erscheint sofort in der Vorschau. Pruefen Sie kurz die Einrueckung und die Anfuehrungszeichen, dann kopieren Sie das Ergebnis in die Zwischenablage oder laden es als .json-Datei herunter. Da alles lokal laeuft, koennen Sie die Eingabe beliebig anpassen und sehen die Auswirkung sofort.
Die Ausgabeformate Array, Keyed und Nested im Vergleich
Der gleiche CSV-Datensatz kann auf mehrere Arten als JSON dargestellt werden. Die folgende Tabelle fasst die drei wichtigsten Formate zusammen, inklusive eines typischen Einsatzfalls.
| Format | Struktur | Typischer Einsatzfall |
|---|---|---|
| Array | Liste von Objekten, ein Objekt pro Zeile | REST-APIs, Tabellen-Import, Standardfall |
| Keyed | Objekt von Objekten, eine Spalte als Schluessel | Schneller Zugriff per ID, Lookups |
| Nested | Verschachtelte Objekte aus Punkt-Notation im Header | Strukturierte Datensaetze, Konfigurationen |
| JSON Lines | Ein JSON-Objekt pro Zeile, ohne umschliessendes Array | MongoDB-Import, Log-Streams, grosse Dateien |
Konkretes Beispiel: aus einer CSV wird ein Array
Angenommen, ein deutscher Excel-Export liefert die folgende, mit Semikolon getrennte CSV mit drei Mitarbeitenden:
id;name;abteilung;aktiv
1;Anna Berger;Vertrieb;true
2;Bjoern Klee;IT;true
3;Carla Mohr;Marketing;falseMit aktivierter Header-Option, Semikolon als Trennzeichen und eingeschalteter Typ-Erkennung entsteht im Array-Format dieses JSON:
[
{ "id": 1, "name": "Anna Berger", "abteilung": "Vertrieb", "aktiv": true },
{ "id": 2, "name": "Bjoern Klee", "abteilung": "IT", "aktiv": true },
{ "id": 3, "name": "Carla Mohr", "abteilung": "Marketing", "aktiv": false }
]Beachten Sie, dass id zur Zahl und aktiv zum booleschen Wert geworden ist, weil die Typ-Erkennung aktiv war. Im Keyed-Format mit der Spalte id als Schluessel saehe dasselbe Ergebnis so aus:
{
"1": { "name": "Anna Berger", "abteilung": "Vertrieb", "aktiv": true },
"2": { "name": "Bjoern Klee", "abteilung": "IT", "aktiv": true },
"3": { "name": "Carla Mohr", "abteilung": "Marketing", "aktiv": false }
}Sonderzeichen, Anfuehrungszeichen und der RFC-4180-Standard
CSV wirkt simpel, hat aber Tuecken. Was passiert, wenn ein Feldwert selbst das Trennzeichen enthaelt, etwa eine Adresse mit Komma? Dafuer gibt es einen offiziellen Standard, RFC 4180. Er legt fest, dass Felder mit Trennzeichen, Zeilenumbruechen oder Anfuehrungszeichen in doppelte Anfuehrungszeichen eingeschlossen werden. Ein doppeltes Anfuehrungszeichen innerhalb eines Felds wird durch zwei aufeinanderfolgende Anfuehrungszeichen maskiert.
Ein RFC-4180-konformer Parser erkennt diese Faelle korrekt. So bleibt der Wert "Mueller, Schmidt & Co." ein einziges Feld, obwohl er ein Komma enthaelt. Achten Sie ausserdem auf die Zeichenkodierung: JSON ist nach der Spezifikation UTF-8, und ein deutsches Excel haengt oft ein UTF-8-BOM (Byte Order Mark) an den Dateianfang. Ein guter Converter entfernt dieses unsichtbare Zeichen, damit der erste Schluessel nicht versehentlich aus etwas wie id besteht.
Datenschutz: warum lokale Umwandlung im Browser zaehlt
Viele bekannte Online-Konverter laden die hochgeladene Datei auf einen Server, verarbeiten sie dort und schicken das Ergebnis zurueck. Bei oeffentlichen Testdaten ist das unproblematisch, bei Kundenlisten, Personaldaten oder Umsatzzahlen aber heikel. Genau hier setzt der lokale Ansatz an: Der Converter auf csv-json.de fuehrt die gesamte Umwandlung mit JavaScript direkt in Ihrem Browser aus. Die Daten werden zu keinem Zeitpunkt an einen Server uebertragen.
Aus Datenschutzsicht ist das ein echter Unterschied. Ohne Uebermittlung an einen Dritten entfaellt die Frage nach Auftragsverarbeitung und Drittlandtransfer, und das Prinzip der Datenminimierung nach Art. 5 Abs. 1 lit. c DSGVO ist sauber eingehalten. Wer mit sensiblen Daten arbeitet, sollte diesen Punkt immer pruefen, bevor er ein Online-Tool nutzt. Mehr dazu im Ratgeber zu RFC 4180, UTF-8 und Datenschutz.
Haeufige Fehler und wie Sie sie vermeiden
Die meisten Probleme beim Umwandeln lassen sich auf wenige Ursachen zurueckfuehren. Diese Uebersicht hilft bei der schnellen Diagnose.
| Symptom | Ursache | Loesung |
|---|---|---|
| Alles in einem Feld | Falsches Trennzeichen | Komma und Semikolon durchtesten |
| Erster Schluessel hat Sonderzeichen | UTF-8-BOM am Dateianfang | BOM-Entfernung aktivieren oder Datei als UTF-8 ohne BOM speichern |
| Fuehrende Nullen fehlen | Typ-Erkennung wandelt in Zahl um | Typisierung abschalten, als String behalten |
| Umlaute werden kryptisch | Falsche Zeichenkodierung (z. B. ANSI statt UTF-8) | Datei in UTF-8 neu exportieren |
| Spaltenzahl variiert | Unmaskierte Trennzeichen oder Zeilenumbrueche in Feldern | Felder RFC-4180-konform in Anfuehrungszeichen setzen |
Haeufige Fragen
Wie wandle ich eine CSV-Datei in JSON um?
CSV-Inhalt in das Eingabefeld einfuegen oder Datei laden, das passende Trennzeichen waehlen (Komma oder Semikolon), die Header-Zeile als Schluessel aktivieren und das gewuenschte Ausgabeformat (Array, Keyed oder Nested) festlegen. Das Ergebnis erscheint sofort und laesst sich kopieren oder als .json-Datei herunterladen. Die Verarbeitung passiert vollstaendig lokal im Browser.
Bleiben meine Daten beim Umwandeln privat?
Ja. Der Converter verarbeitet die CSV ausschliesslich im Browser per JavaScript. Es findet kein Upload auf einen Server statt, die Daten verlassen Ihr Geraet nie. Das ist besonders fuer personenbezogene oder geschaeftliche Daten relevant und entspricht dem Prinzip der Datenminimierung nach Art. 5 DSGVO.
Mein deutsches Excel exportiert mit Semikolon. Funktioniert das trotzdem?
Ja. Deutsche Excel-Versionen verwenden das Semikolon als Standard-Trennzeichen, weil das Komma als Dezimaltrennzeichen belegt ist. Stellen Sie im Converter das Trennzeichen auf Semikolon. Ein vorhandenes UTF-8-BOM am Dateianfang wird erkannt und entfernt, damit der erste Schluessel nicht mit unsichtbaren Zeichen beginnt.
Werden Zahlen und Wahrheitswerte automatisch als JSON-Typen erkannt?
CSV kennt keine Datentypen, alle Werte sind zunaechst Text. Der Converter kann numerische Werte sowie true und false als echte JSON-Typen interpretieren, statt sie als String zu belassen. Wer Werte wie fuehrende Nullen in Postleitzahlen oder Artikelnummern behalten will, deaktiviert die Typ-Erkennung und behaelt alles als String.
Was bedeuten die Ausgabeformate Array, Keyed und Nested?
Array erzeugt eine Liste von Objekten, ein Objekt pro Datenzeile, und ist das gaengigste Format fuer APIs. Keyed nutzt den Wert einer Spalte (etwa eine ID) als Objektschluessel und liefert ein Objekt von Objekten. Nested wandelt Punkt-Notation im Header wie adresse.stadt in verschachtelte Objekte um. Welches Format passt, haengt vom Zielsystem ab.
Wie gross darf die CSV-Datei sein?
Der Converter ist auf Dateien bis etwa 10 MB ausgelegt, was bei den meisten Exporten mehreren zehntausend Zeilen entspricht. Sehr grosse Dateien koennen den Browser ausbremsen, weil das gesamte Ergebnis im Arbeitsspeicher gehalten wird. Fuer Datenmengen im dreistelligen Megabyte-Bereich eignet sich ein zeilenweises Streaming-Verfahren, etwa mit Python oder Node.js und dem Ausgabeformat JSON Lines.
Quellen
- RFC 4180: Common Format and MIME Type for CSV Files, IETF
- RFC 8259: The JavaScript Object Notation (JSON) Data Interchange Format, IETF
- JSON, MDN Web Docs (Mozilla)
- Model for Tabular Data and Metadata on the Web, W3C
- Verordnung (EU) 2016/679 (DSGVO), Art. 5, EUR-Lex
Verwandte Artikel
Jetzt CSV in JSON umwandeln
Daten einfuegen, Format waehlen, fertig. Kostenlos, ohne Anmeldung und vollstaendig lokal in Ihrem Browser.
Zum Converter