ViewCSVAbre o pega un archivo CSV y junto a las opciones aparece una tabla con barras verticales, lista para un README, una incidencia o una página de wiki. Una | dentro de un valor se escribe como \| para que nunca pueda partir una celda, los saltos de línea dentro de una celda se convierten en <br> y las columnas numéricas se alinean a la derecha. El archivo se convierte en tu navegador y nunca se sube.
Cómo convertir un CSV a Markdown
- Elige Abrir archivo, arrastra un archivo
.csv,.tsvo.txtsobre la herramienta o elige Pegar. El delimitador se detecta solo; si no acierta, ajústalo en Configuración de importación, junto con la codificación o la opción La primera fila contiene los nombres de columna. - Elige la Alineación de columnas y cómo se escriben los Saltos de línea dentro de las celdas. La pestaña Markdown muestra el texto exacto que contendrá la descarga.
- Elige Copiar para pegar la tabla directamente en GitHub, GitLab o tu editor, o Descargar Markdown para guardar un archivo
.md.
Si tu archivo no tiene fila de encabezados, desactiva La primera fila contiene los nombres de columna: las tablas Markdown siempre necesitan encabezados, así que las columnas se llamarán Column 1, Column 2, etc. Si prefieres mostrar los mismos datos como tabla web, usa CSV a HTML.
Qué hace cada opción
| Números a la derecha, texto por defecto | La opción predeterminada. Una columna se alinea a la derecha (---:) solo si todos sus valores no vacíos son números simples; con 00731 o 12 kg, la columna mantiene la alineación predeterminada del visualizador. |
|---|---|
| Por defecto (ninguna), Izquierda, Centro, Derecha | Aplican la misma alineación a todas las columnas: --- sin más, :---, :---: o ---: en la fila separadora. |
| Mantener como <br> | Un salto de línea dentro de una celda se convierte en <br>, que GitHub y la mayoría de los visualizadores muestran como una línea nueva dentro de la celda. Es la opción predeterminada. |
| Sustituir por un espacio | Cada salto de línea se convierte en un espacio, para los visualizadores que eliminan el HTML. |
| Escapar caracteres de Markdown | Activada de forma predeterminada. *, _, [, ], <, >, #, ~ y el acento grave reciben una barra invertida, de modo que un valor como *fast* o <b> se muestra tal como se escribió en lugar de convertirse en formato o en HTML. Desactívala solo cuando las celdas contengan Markdown que quieras que se interprete. |
| Alinear las columnas en el texto fuente | Activada de forma predeterminada. Rellena las celdas con espacios para que el archivo .md sin procesar se lea como una cuadrícula. Los caracteres anchos, como los del chino, el japonés o el coreano, cuentan como dos columnas. Desactívala para obtener la salida más pequeña; la tabla mostrada se ve igual. |
Cómo se tratan los datos problemáticos
- Las barras verticales y las barras invertidas siempre se escapan (
\|,\\), incluso con Escapar caracteres de Markdown desactivado, porque una|sin escapar empezaría una celda nueva. - Las comas y los saltos de línea entre comillas se leen según la RFC 4180, así que
"Cable tidy, 3-pack"se queda en una sola celda. Un aviso encima de la vista previa indica cuántos valores contenían un salto de línea. - Los valores se escriben como texto:
00731conserva sus ceros y34.90, su cero final. No se redondea ni se cambia el formato de nada. - Un encabezado vacío pasa a ser
Column 3y uno repetido,name (2), de modo que cada columna tiene un encabezado distinto. - Los visualizadores de Markdown eliminan los espacios al principio y al final de una celda, y una tabla no puede contener listas ni párrafos; guarda ese tipo de contenido en un documento aparte.
Solución de problemas
- El texto que va después de la tabla se une a su última fila. Una tabla solo termina en una línea en blanco o al empezar otro bloque, así que deja una línea vacía después de ella.
- Todos los valores están en una sola columna. El delimitador no se detectó bien. Elige Coma, Punto y coma, Tabulación o Barra vertical en Configuración de importación y vuelve a abrir el archivo.
- En el resultado aparecen barras invertidas delante de * o _. Es el escape en acción, en un visualizador que no lo interpreta. Desactiva Escapar caracteres de Markdown si tus datos no tienen caracteres de formato que proteger.
- Los saltos de línea se muestran como una etiqueta literal. El visualizador no admite HTML. Elige Sustituir por un espacio en Saltos de línea dentro de las celdas.
Límites y privacidad
Los archivos de hasta 25 MB, 100 000 filas o 2 millones de celdas se abren con una vista previa en directo de las primeras 200 filas. Los archivos más grandes se convierten por secuencias: el archivo se lee dos veces por bloques (una para medir las columnas y su ancho, otra para escribir), un aviso indica que la descarga incluye el archivo completo y la opción Copiar no está disponible. Cada archivo de salida está limitado a 4 GB.
La conversión se ejecuta en un proceso en segundo plano de esta pestaña, así que la página sigue respondiendo y Cancelar la detiene. El CSV nunca se envía a un servidor. Para revisar un archivo grande antes de convertirlo, ábrelo en el visor de CSV.
Ejemplo
Una lista de productos con un SKU con ceros a la izquierda, una barra vertical dentro de un nombre, una coma entre comillas y una nota de dos líneas, convertida con los ajustes predeterminados. price se alinea a la derecha porque todos sus valores son números; sku no, porque 00731 se conserva como texto.
sku,name,price,note 00731,"Desk lamp | brass",34.90,"Ships in 2 days from Leeds" 00732,"Cable tidy, 3-pack white",4.50,Back-ordered until 14 March 2025 00733,USB-C hub,129.00,
| sku | name | price | note | | ----- | ------------------------ | -----: | -------------------------------- | | 00731 | Desk lamp \| brass | 34.90 | Ships in 2 days<br>from Leeds | | 00732 | Cable tidy, 3-pack white | 4.50 | Back-ordered until 14 March 2025 | | 00733 | USB-C hub | 129.00 | |
Preguntas frecuentes
¿El resultado funciona en GitHub?
Sí. Es una tabla con barras verticales de GitHub Flavored Markdown: una fila de encabezados, una fila separadora con dos puntos opcionales para la alineación y una línea por cada fila del CSV. GitLab, Obsidian y la mayoría de los generadores de sitios estáticos leen la misma sintaxis.
¿Por qué veo `\|` en el texto fuente?
En una tabla Markdown, una | normal cierra la celda. La barra invertida indica al visualizador que muestre la barra vertical como texto, así que Desk lamp | brass se queda en una sola celda.
¿Puedo convertir una tabla Markdown de vuelta a CSV?
En esta página no. Solo convierte CSV y TSV a Markdown.