Convertir CSV a tabla de texto alineada

Analiza correctamente los campos entre comillas —comas, puntos y coma y saltos de línea dentro de las comillas—, calcula el ancho de cada columna, rellena cada celda para que las columnas queden alineadas y dibuja una línea separadora bajo la cabecera. Cuando una fila tiene un número de campos distinto al de la cabecera, la llamada falla con un error claro en lugar de producir una tabla torcida, salvo que active la opción lenient para rellenar las filas cortas con celdas vacías.

Por qué convertir un CSV en una tabla de ancho fijo

El CSV es el formato en el que viajan los datos, pero es un formato pésimo para leer. Una columna con valores largos empuja el campo siguiente muy a la derecha en una fila y no en otra, de modo que la vista pierde la alineación a las dos líneas. Las hojas de cálculo lo resuelven ocultando el texto por completo, que es justo lo que no quiere cuando el destino es un registro de terminal, un comentario de pull request, un correo en texto plano o documentación en Markdown.

Un conversor de csv a tabla de texto mantiene los datos como texto —copiable, comparable con diff, localizable con grep— mientras recupera lo único que aportaba la hoja de cálculo: columnas alineadas. Pegue la exportación y obtenga un bloque donde cada campo ocupa la misma posición en todas las filas, con una regla de guiones bajo la cabecera.

Al ser texto plano, el resultado sobrevive a cualquier pegado en cualquier herramienta, chat o revisión de código sin perder el formato, y se lee igual en la pantalla de un móvil que en un monitor panorámico.

Cómo funcionan el análisis y la alineación

El analizador sigue las convenciones del RFC 4180: un campo entre comillas dobles puede contener el delimitador, saltos de línea y comillas literales escritas como dos comillas dobles, y las líneas en blanco se ignoran. Esto importa en la práctica porque las exportaciones reales entrecomillan los campos justo cuando contienen algo interesante: una dirección con una coma, una nota con un punto y coma, un mensaje con un salto de línea. Tras el análisis, el renderizador comprueba que cada fila tenga el mismo número de campos que la primera.

Si alguna no lo tiene, la llamada falla con un error que indica la fila y ambos recuentos: una fila a la que le falta una coma final produce una tabla visiblemente desplazada, y una tabla desplazada es peor que ninguna tabla. Si prefiere ver los datos de todos modos, active lenient y las filas cortas se rellenan con celdas vacías hasta la fila más ancha.

A continuación se calcula el ancho de cada columna como la celda más larga, cada celda se rellena hasta ese ancho y las columnas se unen con una barra vertical. Cuando la primera fila es una cabecera, se dibuja una regla de guiones debajo. Todo es determinista: la misma entrada produce siempre una salida idéntica byte a byte.

Delimitadores, cabeceras y uso cotidiano

No todo CSV usa comas. Las exportaciones europeas suelen usar puntos y coma, y muchos volcados de bases de datos usan tabulaciones o barras verticales. Pase el carácter en el campo delimiter y todo lo demás funciona igual: campos entre comillas, detección de errores y relleno leniente.

Si sus datos no tienen fila de cabecera, ponga header en false y la primera fila se renderiza como datos, sin línea separadora. La capacidad se ejecuta en el borde sin guardar nada: el texto se analiza, se renderiza y se descarta. Quienes la usan suelen ser scripts de publicación que imprimen una tabla resumen en los registros de CI, bots que responden con una tabla legible en el chat y generadores de documentación que incrustan datos de ejemplo alineados.

Se aceptan entradas de hasta 1 MB y 50.000 filas, lo que cubre con holgura cualquier exportación que una persona pegaría y la mayoría de las generadas por máquinas.