NDJSON-Datei — was sie ist und was sie öffnet

Was NDJSON ist

NDJSON ist ein reines Textformat, das sich in jedem Editor öffnen lässt. Eingesetzt wird es für den Austausch zwischen Programmen und das Streaming.

Die Endung lautet .ndjson, der volle Name Newline-Delimited JSON. Beides sagt weniger aus als das, was die Datei halten kann — und davon handelt der Rest dieser Seite.

Woher NDJSON kommt

Es geht auf 2013 zurück.

Das Alter ist aus einem praktischen Grund interessant: je älter ein Format, desto mehr Programme hatten Zeit, es zu lernen.

Die Spezifikation ist öffentlich

Jeder darf sie umsetzen, ohne zu fragen und ohne zu zahlen. Deshalb taucht das Format in so vielen Programmen auf, und deshalb gehen Dateien von vor zwanzig Jahren heute noch auf.

Es wird nichts weggeworfen

NDJSON speichert seinen Inhalt exakt. Erneutes Speichern ändert nichts, es lässt sich also beliebig oft öffnen, bearbeiten und wieder ablegen, ohne dass sich Schaden ansammelt — genau das macht es zu einem Arbeitsformat und nicht zu einem Ausgabeformat.

Was es sonst noch tragen kann

NDJSON kann einen Aufbau, mit dem es losspielen kann, bevor es vollständig angekommen ist halten.

Wichtig wird das vor allem beim Umwandeln: Was das Ziel nicht halten kann, fällt weg, meist ohne Warnung.

Für eine Notiz ist kein Platz

NDJSON hat keine Kommentarsyntax. Alles Erklärende muss außerhalb der Datei leben — gut zu wissen, bevor man sie für etwas wählt, das ein Mensch von Hand pflegt.

Was NDJSON öffnet

jq und pandas lesen es, und die meisten Programme derselben Art ebenfalls.

Wenn eine Datei nicht aufgeht, liegt es selten am Format — häufiger daran, dass das Programm älter ist als das Format. Die Umwandlung in etwas Älteres ist der verlässliche Weg daran vorbei, und dafür gibt es den Rest dieser Website.

Im Browser öffnen

Kein Browser liest es.

Das ist der häufigste Grund, es umzuwandeln: nicht dass das Format schlecht wäre, sondern dass die Stelle, an der die Datei erscheinen soll, es nicht lesen kann.

Es ist ein Arbeitsformat

NDJSON ist zum Öffnen und Ändern gedacht. Behalte die Datei in diesem Format, solange die Arbeit läuft, und exportiere daraus, wann immer eine fertige Fassung gebraucht wird.

Die Eckdaten auf einen Blick

Kennungen und Herkunft des Formats NDJSON.
Endung	.ndjson, .jsonl
Medientyp	application/x-ndjson
Erstmals veröffentlicht	2013

Was ist eine NDJSON-Datei?