Convertir CSV a Markdown

1. 1

   Suelte el CSV

   Arrastre un archivo .csv, .tsv, .txt o .psv a la página, o búsquelo. El delimitador, el carácter de comillas y la codificación se leen del propio archivo, y la herramienta indica cuál eligió.

2. 2

   Revise la vista previa renderizada

   La vista previa muestra la tabla tal como se renderizará, no solo el texto en crudo, así que verá de inmediato si una celda con un asterisco o un salto de línea se va a comportar.

3. 3

   Ajuste alineación y formato

   Elija una alineación para toda la tabla o por columna desde la cabecera de la vista previa. Active la salida alineada para un texto en crudo legible, el escape para celdas con caracteres Markdown, filas numeradas, o primera fila o columna en negrita.

4. 4

   Copie o descargue

   Pulse Convertir y luego Copiar para llevar la tabla al portapapeles para un README o una pull request, o descárguela como archivo .md con el nombre que quiera. Todo se ejecuta en su dispositivo.

Convierta CSV en una tabla Markdown con sabor GitHub, con las dos cosas que deciden si el resultado es utilizable: un escape correcto y control sobre cómo se alinea cada columna. Use la primera fila como cabecera o genere etiquetas de columna, fije la alineación para la tabla o por columna, alinee la salida o manténgala compacta, y vea la tabla renderizada junto al Markdown en crudo antes de copiarla.

• Formato de tabla Markdown — Markdown con sabor GitHub: una fila de cabecera, una fila separadora que lleva la alineación y una fila por registro. Se renderiza en GitHub, GitLab, Obsidian, Notion, VS Code, Jira y Confluence sin cambios.
• Alineación por columna — Fije un valor por defecto para la tabla y sobrescriba cualquier columna desde el desplegable de su cabecera en la vista previa. Izquierda, centro, derecha o ninguna.
• Primera fila como cabecera — Use la primera fila del CSV como cabecera de la tabla, o desactívelo para tratar todas las filas como datos con etiquetas Col 1, Col 2 generadas.
• Un escape que aguanta — Las barras verticales y las barras invertidas se escapan siempre, los saltos de línea dentro de una celda pasan a <br>, y los asteriscos, guiones bajos, comillas invertidas, corchetes, signos de menor/mayor y tildes también pueden escaparse.
• Alineada o compacta — Alinee todas las columnas para que el archivo en crudo cuadre en un editor de texto, o manténgalo compacto para que una tabla regenerada produzca el diff más pequeño posible.
• Vista previa renderizada y vista en crudo — Vea la tabla tal como se renderizará y el Markdown tal como se escribirá, y alterne entre ambas. Cada ajuste cambia al menos una de las dos.
• Copiar o descargar — Lleve la tabla directamente al portapapeles para un README o una pull request, o descárguela como archivo .md con el nombre que elija.

Una tabla Markdown son tres tipos de línea, y saber cuál es cuál explica todas las opciones de esta página. La herramienta escribe las tres por usted, pero conviene entender la forma porque es la que decide dónde se rompe una tabla.

La cabecera y el separador

• Fila de cabecera — Una línea de celdas entre barras verticales. Siempre se renderiza en negrita, por eso ponerla en negrita otra vez no hace nada y por eso las opciones de negrita de esta herramienta se aplican al cuerpo.
• Fila separadora — La línea de guiones justo debajo de la cabecera. No es decoración: su presencia es lo que convierte el bloque en una tabla, y los dos puntos que contiene son la única forma de fijar la alineación.
• Filas de datos — Una línea por registro. Una fila con menos celdas que la cabecera se rellena; una con más sería truncada por la mayoría de los renderizadores, así que los archivos irregulares se cuadran a la fila más ancha.

Las dos cosas que rompen una tabla

• Una barra vertical sin escapar — Una barra vertical dentro de una celda termina esa celda antes de tiempo, así que la fila gana una columna y el renderizador desplaza o pierde los datos. Esta herramienta escapa siempre todas las barras verticales — no es una opción porque no hay ningún caso en el que el carácter en crudo sea lo que usted quería.
• Un salto de línea dentro de una celda — Una fila de tabla Markdown es una sola línea. Un campo CSV entrecomillado que contenga un salto de línea — una dirección postal, un comentario — terminaría la fila por la mitad y todas las filas posteriores se caerían de la tabla. Vea la sección de saltos de línea más abajo para las tres formas en que esta herramienta lo resuelve.

La alineación vive en la fila separadora, como dos puntos. Esta herramienta la escribe por usted, y puede diferir por columna, que es lo que se quiere en cuanto una tabla mezcla etiquetas con números.

• Izquierda — :--- — El valor por defecto, y lo correcto para nombres, etiquetas y texto libre. Dos puntos a la izquierda de los guiones.
• Centro — :---: — Dos puntos a ambos lados. Útil para columnas de estado cortas y marcas de un solo carácter, donde centrar se lee mejor que un borde izquierdo irregular.
• Derecha — ---: — Dos puntos a la derecha. Es la que importa para los números: las cifras alineadas a la derecha cuadran en el punto decimal, así que una columna de precios o de recuentos se puede comparar de un vistazo.
• Ninguna — --- — Sin dos puntos. El renderizador usa su propio valor por defecto, que es la izquierda en todos los que conocemos, y la fila separadora queda lo más corta posible.
• Por columna — La cabecera de cada columna en la vista previa lleva su propio desplegable. Fije el valor por defecto una vez y luego sobrescriba las dos columnas numéricas a Derecha: una tabla de nombres y cifras se lee correctamente con unos cuatro clics.

El texto que llega de una hoja de cálculo no sabe que está a punto de convertirse en Markdown, y varios caracteres perfectamente corrientes significan algo en cuanto lo hace. La herramienta separa lo que corrige siempre de lo que usted elige.

Siempre escapado

• Barras verticales — Se escriben como \| . Una barra vertical sin escapar termina la celda, lo que desplaza o pierde datos: no hay versión de eso que nadie quiera, así que no es un interruptor.
• Barras invertidas — Se duplican a \\ , y se hace primero para que las barras invertidas que añaden las demás reglas no se dupliquen a su vez. Una ruta de Windows en una celda sobrevive intacta.

A su elección

• Caracteres Markdown — Asteriscos, guiones bajos, comillas invertidas, corchetes, signos de menor/mayor y tildes. Una celda que dice *nota* se renderiza en cursiva y sin los asteriscos; escapada, se lee como *nota*. Desactivado por defecto, porque la mayoría de las tablas no contienen ninguno y las barras invertidas se ven en el archivo en crudo.
• Saltos de línea: <br> — El valor por defecto. Un salto dentro de una celda pasa a ser un salto de línea HTML, que admite todo renderizador de Markdown que admita tablas, así que una dirección de varias líneas sigue siendo una celda y sigue siendo legible.
• Saltos de línea: \n — Una barra invertida y una n literales. Lo correcto cuando la tabla va a un sitio que elimina el HTML, y cuando importa que hubiera un salto sin que se renderice como tal.
• Saltos de línea: espacio — El salto pasa a ser un solo espacio. La salida más corta, y la elección correcta cuando los saltos son un artefacto de la exportación y no significado.
• Lo que no se escapa — Los guiones, los puntos y los signos más se dejan en paz. Escaparlos es técnicamente válido y convierte cada fecha en 2026\-01\-01 y cada precio en 12\.50, que ningún renderizador necesita y ningún lector quiere.

La mitad de lo que hace que una tabla convertida esté mal ocurre antes de escribir ningún Markdown. Estos tres ajustes deciden qué son las filas, y los tres se detectan del archivo con una anulación al lado.

• Delimitador — Coma, punto y coma, tabulación o barra vertical, detectado analizando una muestra con cada candidato y quedándose con el que produce anchos de fila más consistentes. Contar separadores en la primera línea — el atajo habitual — lee "a,b,c,d";"e";"f" como separado por comas y colapsa cada fila en una sola columna.
• Carácter de comillas — Comilla doble, apóstrofo o ninguno, detectado del mismo modo. Una comilla solo abre un campo en primera posición, así que un apóstrofo en O'Brien sigue siendo un apóstrofo en lugar de tragarse el resto de la fila.
• Codificación — Auto por defecto: la marca de orden de bytes gana cuando el archivo la tiene; si no, los bytes se comprueban como UTF-8 válido y se recurre a Windows-1252. Fuerce UTF-8, UTF-16LE, UTF-16BE, Windows-1252 o ISO-8859-1 cuando un archivo no lleva marca y la suposición falla.
• ISO-8859-1 no es Windows-1252 — La plataforma web trata la primera como una etiqueta de la segunda, así que la mayoría de las herramientas ofrecen ambas y le dan una. Aquí ISO-8859-1 es de verdad Latin-1 byte a punto de código, lo que importa para archivos donde 0x80 a 0x9F son códigos de control y no comillas tipográficas.
• Marcas de orden de bytes — La exportación CSV UTF-8 de Excel escribe una, y una herramienta que no la elimina pone un carácter invisible al principio del título de su primera columna. Aquí se elimina, y si contradice la codificación que usted eligió la herramienta lo dice en lugar de anularle en silencio.

Ambas producen la misma tabla renderizada. La diferencia es el aspecto del archivo en crudo, y cuál quiere depende enteramente de quién lo lea así.

• Alineada — Cada celda se rellena para que las barras verticales queden en columna. El Markdown en crudo se lee como una tabla en cualquier editor de texto plano, que es lo que se quiere cuando alguien va a abrir el archivo .md en lugar de una página renderizada.
• Compacta — Un espacio a cada lado de cada celda, nada más. La salida es más pequeña y — más útil — un valor que cambia en una fila no vuelve a rellenar todas las demás, así que una tabla regenerada y versionada en git produce un diff de una línea en lugar de uno de archivo entero.
• El relleno sigue a la alineación — Una columna alineada a la derecha se rellena por la izquierda; una centrada, por ambos lados. Así el texto en crudo cuadra igual que lo hará la tabla renderizada, que es el sentido de rellenarlo.
• Filas numeradas — Añade una columna inicial que cuenta las filas del cuerpo desde uno. Útil para referirse a una fila en un comentario de revisión, y no forma parte de sus datos: se regenera cada vez que se regenera la tabla.
• Primera fila o columna en negrita — Envuelve la primera fila del cuerpo, o la primera columna de cada fila del cuerpo, en dobles asteriscos. La fila de cabecera ya se renderiza en negrita, así que estas opciones se aplican deliberadamente al cuerpo: volver a poner la cabecera en negrita sería un control que no hace nada.

Una exportación de 25 MB — unas 225.000 filas — se convierte en alrededor de un segundo en un ordenador de sobremesa, en un hilo en segundo plano, así que la página nunca se congela.

Las exportaciones reales rara vez son solo una cabecera y filas. Cuatro controles se ocupan de las partes que no deberían convertirse en celdas de tabla.

• Omitir filas iniciales — Elimina filas desde arriba antes de cualquier otra cosa. Los informes y las exportaciones de paneles suelen llevar un título, una fecha y una línea en blanco sobre la cabecera real; omítalas y la fila uno pasa a ser la cabecera que debería haber sido.
• Limitar filas — Limita cuántas filas de datos se escriben. Un README quiere las primeras veinte filas de una exportación grande, no las cuarenta mil — y la vista previa muestra exactamente lo que se producirá.
• Eliminar filas vacías — Elimina cualquier fila en la que todas las celdas estén en blanco. Las exportaciones de hojas de cálculo las acumulan al final, y cada una se convierte en una fila de celdas vacías en la tabla.
• Eliminar columnas vacías — Elimina cualquier columna sin datos. Cuando hay fila de cabecera, el título por sí solo no conserva la columna: una columna sin usar pero con nombre es exactamente el caso para el que existe este control, y su título se va con ella.

Un archivo se convierte en el plan gratuito con todos los controles de formato disponibles. Convertir muchos a la vez es lo que añade el plan Pro, y viene en dos formas porque son dos trabajos genuinamente distintos.

• Un lote de archivos — Ponga en cola hasta cincuenta CSV, conviértalos en una sola acción y llévese el resultado como un único ZIP. Los nombres de archivo duplicados se hacen únicos dentro del archivo comprimido en lugar de sobrescribirse entre sí.
• Un documento combinado — La misma cola escrita en un único archivo Markdown, cada tabla bajo un encabezado tomado de su nombre de archivo. Es la forma que quiere para una página de documentación que tiene que mostrar cuatro tablas relacionadas en un mismo sitio.
• Los ajustes se aplican a la cola — La alineación, el relleno, el escape y lo demás se aplican a todos los archivos del lote, así que un conjunto de exportaciones sale consistente. La alineación por columna sigue siendo por archivo, porque las columnas difieren.
• Todo sigue en su dispositivo — Un lote es el mismo motor ejecutado más veces. Nada se sube, la cola está limitada por su propia memoria y no por un servidor, y el techo de tamaño en el plan Pro es lo que su dispositivo pueda soportar.

La tabla que escribe esta herramienta es Markdown con sabor GitHub, el dialecto en el que casi todo ha convergido. Unos pocos destinos tienen peculiaridades que conviene conocer antes de pegar.

• GitHub y GitLab — README, incidencias, descripciones de pull requests y wikis. Los dos puntos de alineación se respetan, y <br> dentro de una celda se renderiza como salto de línea.
• Obsidian y VS Code — Ambos renderizan tablas en vista previa y ambos leen el archivo en crudo constantemente, que es el caso para el que existe la salida alineada.
• Notion — Pegar una tabla Markdown crea una tabla real de Notion. La alineación no se traslada, así que los dos puntos no hacen daño pero tampoco hacen nada.
• Jira y Confluence — Jira moderno convierte una tabla Markdown pegada. Confluence antiguo usa su propio marcado de tablas, así que pegue en una macro Markdown y no en el cuerpo de la página.
• Generadores de sitios estáticos — Jekyll, Hugo, Docusaurus, MkDocs y Astro renderizan tablas GFM en archivos de contenido. La salida compacta mantiene pequeños los diffs de origen cuando una tabla se regenera a partir de datos.

Las tablas Markdown se usan en README, documentación y sitios estáticos. Convertir CSV a Markdown le permite incrustar datos tabulares en contenido basado en Markdown, y los mantiene en el mismo control de versiones que el código que documentan.

• Documentación y README — Coloque tablas en la documentación sin escribir una sola barra vertical, y sin una captura de pantalla que queda obsoleta en cuanto cambian las cifras.
• Texto portable — Markdown mantiene los datos legibles en repositorios, wikis y generadores estáticos — y legibles como texto plano cuando nada los renderiza.
• Revisable en un diff — Una tabla guardada como texto muestra qué cambió línea a línea en una pull request. Una hoja de cálculo adjunta al mismo commit no muestra nada.
• Sin dependencias que instalar — El resultado es texto. No necesita plugin, extensión ni entorno de ejecución allá donde acabe, lo que no es cierto de una hoja incrustada ni de la imagen de un gráfico.

• Delimitador — Detección automática por consistencia, o elija coma, punto y coma, tabulación o barra vertical.
• Carácter de comillas — Detección automática, comilla doble, apóstrofo o ninguno.
• Codificación — Auto con detección de marca de orden de bytes, UTF-8, UTF-16LE, UTF-16BE, Windows-1252 o un ISO-8859-1 real.
• Primera fila como cabecera — Activado, la fila uno es la cabecera de la tabla; desactivado, todas las filas son datos y se generan etiquetas Col 1, Col 2.
• Alineación — Izquierda, centro, derecha o ninguna para la tabla, sobrescribible por columna desde la cabecera de la vista previa.
• Salida alineada — Cuadre las columnas en el archivo en crudo, o manténgalo compacto para diffs más pequeños.
• Escapar caracteres Markdown — Escapa asteriscos, guiones bajos, comillas invertidas, corchetes, signos de menor/mayor y tildes además de las barras verticales y barras invertidas que se escapan siempre.
• Saltos de línea en una celda — Convierta un salto en <br>, en un \n literal o en un espacio.
• Filas numeradas, fila y columna en negrita — Una columna que cuenta, una primera fila de datos en negrita y una primera columna en negrita — de forma independiente.
• Omitir, limitar y recortar — Elimine filas iniciales, limite el número de filas y quite filas y columnas que no contienen nada.
• Descargar como — Nombre de archivo personalizado para el .md; la extensión se añade si usted la omite.

• CSV a JSON
• CSV a XML
• CSV a Excel
• Herramientas CSV
• An OpenDocument spreadsheet

  Same typed columns and frozen header, for readers who use LibreOffice rather than Excel

• Cut it down first

  A README wants the rows that matter, not all forty thousand of them