Conversor de CSV a tabla Markdown
Convierte archivos CSV a la sintaxis de tabla Markdown (`| col1 | col2 |`). Puedes elegir el delimitador, si la primera línea se usa como encabezado, y la alineación de columnas (izquierda, centro, derecha). El resultado se puede copiar o descargar. La conversión se realiza completamente en tu navegador; no se envían datos a ningún servidor.
| Delimitador |
|
|---|---|
| Usar la primera línea como encabezado | |
| Alineación de columnas |
|
Introduce datos CSV para ver aquí la tabla Markdown generada.
Cómo se transforma una fila CSV en una tabla Markdown
| Una fila de CSV | name,age,city |
|---|---|
| Sintaxis Markdown resultante | | name | age | city | |
Cuando la primera línea se usa como encabezado, se convierte en la fila de encabezado, seguida de una fila delimitadora (---) que indica la alineación, y cada fila siguiente se convierte en una fila de datos.
Qué es un conversor de CSV a tabla Markdown
Una tabla Markdown se dibuja únicamente con barras verticales y guiones, lo que la hace perfectamente legible como texto plano, pero tedioso de escribir a mano en cuanto hay más de un par de columnas. Si los datos de origen ya existen como CSV —exportados desde una hoja de cálculo, el resultado de una consulta a una base de datos o un archivo de registro— no tiene sentido volver a teclearlos celda por celda. Esta herramienta lee el CSV y lo reconstruye como una tabla Markdown completa: una fila de encabezado, una fila delimitadora que marca la alineación de las columnas y una fila de datos por cada línea del origen.
Como una fila de tabla Markdown debe caber en una sola línea física, durante la conversión se aplican automáticamente algunos ajustes. Las barras verticales que aparecen dentro de una celda se escapan para que no se confundan con un límite de columna, y los saltos de línea dentro de celdas multilínea entre comillas se comprimen en un solo espacio. También puedes elegir alineación izquierda, centrada o derecha para las columnas, lo que inserta el patrón de dos puntos y guiones correspondiente en la fila delimitadora. Todo el proceso se ejecuta localmente en tu navegador, así que el CSV que pegas nunca sale de tu equipo.
Cómo generar una tabla Markdown a partir de un CSV
- Pega los datos CSV Pega el texto CSV en el cuadro de entrada. Si lo copiaste directamente desde una hoja de cálculo, cambia el delimitador a tabulador en lugar de coma.
- Decide si la primera fila es un encabezado Si la primera línea contiene los nombres de las columnas, activa "Usar la primera línea como encabezado" y la fila delimitadora se insertará automáticamente debajo.
- Elige una alineación de columnas Las columnas numéricas suelen leerse mejor alineadas a la derecha. Si dejas la alineación sin especificar, el renderizador Markdown aplicará su propio comportamiento por defecto.
- Copia el resultado en tu documento Copia el Markdown generado y pégalo en un README, un issue, la descripción de un pull request o un artículo técnico.
Consejos para aprovecharla mejor
- Cualquier carácter de barra vertical (|) dentro de una celda se escapa automáticamente como \| para que no se confunda con un separador de columnas.
- Los saltos de línea dentro de celdas multilínea entre comillas se reemplazan por un espacio, ya que una fila de tabla Markdown debe caber en una sola línea física.
- Al elegir alineación "Izquierda", "Centro" o "Derecha" se inserta `:---`, `:---:` o `---:` en la fila delimitadora, de modo que renderizadores como GitHub muestren las columnas con la alineación deseada.
- Combínalo con las herramientas hermanas CSV a JSON y CSV a SQL para convertir un mismo CSV al formato de salida que necesites.
Dónde resulta útil un conversor de CSV a Markdown
Tablas en un README
Organiza primero en una hoja de cálculo una matriz de compatibilidad o una lista de opciones de configuración, y luego conviértela: obtendrás una tabla Markdown limpia sin pelearte con el ancho de las columnas a mano.
Comparativas en issues y pull requests
Convierte resultados de pruebas o una lista de candidatos en una tabla al instante. Al seguir siendo texto plano, también se lee bien dentro de un diff.
Preparar datos para un artículo técnico
Los datos de una medición pueden pasar directamente a un artículo como tabla. Alinear a la derecha las columnas numéricas mantiene las cifras alineadas y fáciles de comparar de un vistazo.
Poner en orden actas y documentación
Resulta útil al trasladar una lista que antes se gestionaba en una hoja de cálculo a documentación mantenida en Markdown.
Términos de las tablas Markdown
- Sintaxis de tabla
- La notación de Markdown para disponer una tabla como celdas separadas por barras verticales. No formaba parte de la especificación original y se añadió más tarde como extensión.
- Fila delimitadora
- La fila de guiones que se coloca justo debajo de la fila de encabezado. Le indica al analizador dónde termina el encabezado y empiezan los datos.
- Marcador de alineación
- Los dos puntos añadidos junto a los guiones de la fila delimitadora para indicar alineación izquierda, centrada o derecha en esa columna.
- GFM
- Abreviatura de GitHub Flavored Markdown, una especificación ampliada definida por GitHub que se ha convertido en el estándar de facto para la sintaxis de tablas.
- Escapado
- El proceso de anteponer una barra invertida a una barra vertical dentro de una celda para que no se confunda con un separador de columnas.
Preguntas frecuentes
A propósito — Por qué las tablas Markdown no necesitan más que barras verticales y guiones
Markdown fue ideado en 2004 por John Gruber y Aaron Swartz como un lenguaje de marcado ligero construido en torno a la idea de que el texto plano debe seguir teniendo sentido tal cual se lee. La sintaxis de tabla no es una excepción: como las líneas se dibujan únicamente con barras verticales y guiones, no hace falta abrir y cerrar etiquetas como la <table> de HTML, y la forma de la tabla es reconocible con solo mirar el código fuente sin renderizar.
La sintaxis de tabla nunca formó parte de la especificación original de Markdown de John Gruber; se añadió más tarde como extensión gracias a PHP Markdown Extra y, de forma más influyente, a GitHub Flavored Markdown (GFM). Por eso persisten diferencias sutiles de comportamiento entre implementaciones (como el manejo de un número de columnas no coincidente), y la mayoría de las plataformas principales —GitHub, GitLab y similares— siguen en líneas generales el GFM.
La necesidad de pegar directamente en la documentación el resultado de una hoja de cálculo o de una base de datos surge constantemente al escribir README, issues y artículos técnicos. Escribir a mano las barras verticales y las filas delimitadoras resulta tedioso, así que un conversor de CSV de un solo clic se ha convertido en un paso de preparación habitual para quienes documentan en Markdown.