CSV a tabla Markdown
Pega un CSV o sube un archivo y obtén al instante una tabla en GitHub-flavored Markdown. El delimitador se detecta automáticamente, las columnas se rellenan para que la tabla quede alineada en texto plano, y puedes alinear cada columna a la izquierda, al centro o a la derecha mientras ves la vista previa renderizada.
Última actualización:
Cómo usar CSV a tabla Markdown
- Pega tu CSV en el cuadro de entrada, o sube o arrastra un archivo .csv, .tsv o .txt. También funcionan los datos copiados de Excel o Google Sheets (separados por tabulaciones).
- Comprueba el delimitador. Se detecta automáticamente; elige uno manualmente si la vista previa no se ve bien.
- Define el encabezado y la alineación. Usa la primera fila como encabezado y elige izquierda, centro o derecha para cada columna encima de la vista previa.
- Elige salida legible o compacta. La legible rellena todas las columnas al mismo ancho para que el código sea fácil de leer.
- Copia o descarga el Markdown y pégalo en un README, issue de GitHub, wiki o página de documentación.
Sintaxis de las tablas Markdown
Una tabla de GitHub-flavored Markdown (GFM) consta de una fila de encabezado, una fila separadora y cualquier número de filas de contenido, con las celdas separadas por barras verticales:
| Tool | Price | Rating |
| :------------- | ----: | :----: |
| Markdown Editor | 0 | 4.8 |
| Team Plan | 12.50 | 4.5 |Los dos puntos de la fila separadora definen la alineación de cada columna. Los espacios usados para alinear las columnas son opcionales: los renderizadores los ignoran, pero hacen que la tabla sea mucho más fácil de leer y revisar en texto plano, en diffs y en pull requests.
| Separador | Alineación | Uso habitual |
|---|---|---|
--- | Predeterminada (normalmente izquierda) | Texto general |
:--- | Izquierda | Nombres, descripciones |
:---: | Centro | Estados cortos, iconos, valoraciones |
---: | Derecha | Números y precios, para que los decimales se alineen |
Límites de las tablas Markdown
- Una línea por fila. Las celdas no pueden contener saltos de línea reales, así que se escriben como
<br>, que GitHub y la mayoría de los renderizadores muestran como una nueva línea. - Sin celdas combinadas. GFM no tiene colspan ni rowspan. Repite el valor o deja celdas vacías.
- El encabezado es obligatorio. Toda tabla GFM necesita una fila de encabezado; si tu CSV no la tiene, se añaden encabezados genéricos "Columna 1, Columna 2".
- Las barras verticales deben escaparse. Un
|literal dentro de una celda se escribe como\|. El Markdown en línea como**negrita**,`código`y los enlaces sigue funcionando dentro de las celdas. - Las tablas grandes se vuelven difíciles de manejar. Con más de unas decenas de filas o columnas muy anchas, considera enlazar al archivo CSV; GitHub muestra por sí solo los archivos .csv como tablas con búsqueda.
Preguntas frecuentes
¿Cómo hago una tabla Markdown a partir de un CSV?
Pega aquí el CSV. Cada fila del CSV se convierte en una fila de la tabla con las celdas separadas por caracteres |, y se añade una fila separadora como | --- | --- | bajo el encabezado. Copia el resultado en cualquier archivo Markdown que admita tablas de GitHub.
¿Cómo funciona la alineación de columnas en Markdown?
La alineación se define en la fila separadora bajo el encabezado: :--- alinea a la izquierda, :---: centra y ---: alinea a la derecha. Un --- simple usa la opción predeterminada del renderizador, que suele ser la izquierda. Elige la alineación de cada columna con los selectores encima de la vista previa.
¿Qué pasa con las comas, comillas y barras verticales dentro de las celdas?
Los campos CSV entre comillas como "Smith, John" se quedan en una celda y las comillas dobles "" se convierten en una sola. Un | dentro de una celda rompería la tabla Markdown, así que se escapa como \|. Los saltos de línea dentro de una celda se convierten en <br> porque las celdas de una tabla Markdown deben estar en una sola línea.
¿Puedo pegar datos de Excel o Google Sheets?
Sí. Al copiar celdas de una hoja de cálculo, el portapapeles recibe texto separado por tabulaciones. Pégalo y el delimitador de tabulación se detecta automáticamente.
Mi CSV no tiene fila de encabezado. ¿Qué hago?
Desactiva Usar la primera fila como encabezado. Las tablas Markdown requieren un encabezado, así que la herramienta añade uno genérico (Columna 1, Columna 2, ...) que puedes editar después.
¿Qué sitios muestran estas tablas?
GitHub, GitLab, Bitbucket, Gitea, Obsidian, la importación de Notion, Docusaurus, MkDocs, Jekyll (kramdown), Hugo y la mayoría de los editores Markdown admiten tablas con barras verticales. El Markdown.pl original no, así que revisa tu renderizador si muestra las barras sin procesar.
¿Se prueban todas las herramientas de FreeToolCabin para comprobar su calidad y precisión?
Sí. Cada herramienta del sitio pasa pruebas automáticas en navegadores reales para comprobar que el resultado es correcto y que no hay errores. Si encuentras un fallo o tienes una sugerencia, escríbenos a [email protected] y lo revisaremos.
Herramientas relacionadas
Ver todas las de Conversores de datos y formatos de archivo →