NDJSON

¿Qué es un archivo NDJSON?

Un objeto JSON por línea. Lo que emiten las tuberías de registros y las exportaciones de datos.

Qué es NDJSON

NDJSON es un formato de texto plano que se abre en cualquier editor. Se usa para mover datos entre programas y la transmisión.

La extensión es .ndjson y el nombre completo, Newline-Delimited JSON. Ambos importan menos que lo que el archivo puede contener, y de eso trata el resto de esta página.

De dónde viene NDJSON

Se remonta a 2013.

La edad interesa por un motivo práctico: cuanto más antiguo es un formato, más programas han tenido tiempo de aprenderlo.

La especificación es pública

Cualquiera puede implementarla sin pedir permiso ni pagar licencia. Por eso aparece en tantos programas, y por eso los archivos escritos hace veinte años siguen abriéndose hoy.

No se tira nada

NDJSON guarda su contenido exactamente. Volver a guardarlo no cambia nada, así que puedes abrirlo, editarlo y guardarlo tantas veces como quieras sin acumular daño; eso es lo que lo convierte en un formato de trabajo y no de entrega.

Qué más puede llevar

NDJSON puede contener una disposición que le permite empezar a reproducirse antes de haber llegado entero.

Eso importa sobre todo al convertir: lo que el destino no puede contener se descarta, casi siempre sin aviso.

No hay dónde dejar una nota

NDJSON no tiene sintaxis de comentarios. Todo lo explicativo tiene que vivir fuera del archivo, y conviene saberlo antes de elegirlo para algo que una persona vaya a editar a mano.

Qué abre NDJSON

jq y pandas lo leen, y también la mayoría de programas del mismo tipo.

Cuando un archivo no se abre, el formato rara vez es el problema: lo más habitual es que el programa sea anterior al formato. Convertir a algo más antiguo es la salida fiable, y para eso está el resto de este sitio.

Abrirlo en el navegador

Ningún navegador lo lee.

Ese es el motivo más frecuente para convertirlo: no que el formato sea malo, sino que el sitio donde quieres mostrar el archivo no sabe leerlo.

Es un formato de trabajo

NDJSON está pensado para abrirse y cambiarse. Guarda el archivo en este formato mientras el trabajo siga en marcha y exporta desde él cada vez que haga falta una copia terminada.

Los datos, en un solo sitio

Identificadores y procedencia del formato NDJSON.
Extensión.ndjson, .jsonl
Tipo de medioapplication/x-ndjson
Primera publicación2013

Convertir NDJSON a otra cosa

Convertir otra cosa a NDJSON

Formatos que puedes usar en lugar de NDJSON