Qué hace
Escribir tablas Markdown a mano es tedioso: cada fila necesita barras verticales, la segunda línea necesita guiones y mantener las columnas alineadas lleva muchísimo tiempo. Esta herramienta convierte datos CSV o TSV en una tabla de GitHub Flavored Markdown que puedes pegar en un README, un pull request, un issue, una wiki o cualquier documentación en Markdown.
El CSV se analiza correctamente, así que se manejan los campos entre comillas con comas, las comillas duplicadas y las celdas de varias líneas. La salida se rellena con espacios para que las columnas queden alineadas en texto plano, lo que facilita leer y editar la tabla después.
Cómo se usa
- Pega CSV o TSV, sube un archivo
.csvo.tsv, o pulsa Ejemplo. - Elige la Alineación: predeterminada, izquierda, centro, derecha o Números a la derecha para alinear a la derecha las columnas que solo contienen números.
- Deja activado La primera fila es el encabezado si la primera fila tiene los nombres de columna; si no, el encabezado será Column 1, Column 2, etc.
- Desactiva Alinear columnas si prefieres filas compactas sin relleno.
- Copia la tabla o descárgala como archivo
.md.
Las filas con menos celdas que el encabezado se completan con celdas vacías, así que la tabla siempre es válida.
Ejemplo
Este CSV:
Tool,Stars,Notes
ripgrep,48000,"Fast, recursive search"
fd,34000,find | but friendlierse convierte en esta tabla Markdown con la alineación Números a la derecha:
| Tool | Stars | Notes |
| ------- | ----: | ---------------------- |
| ripgrep | 48000 | Fast, recursive search |
| fd | 34000 | find \| but friendlier |La coma del campo entre comillas se queda en la celda, la barra vertical se escapa y la columna numérica recibe el marcador --: para alinearse a la derecha al renderizar.
Consejos
- Los marcadores de alineación de la segunda fila (
:--,:-:,--:) controlan cómo se alinea cada columna en la tabla renderizada. - El Markdown en línea dentro de las celdas, como
**negrita**, código en línea o enlaces, se conserva y la mayoría de los visores lo renderizan. - Las tablas muy anchas se leen mal en pantallas pequeñas; considera repartir las columnas en varias tablas.
- Para crear una tabla HTML, o para convertir un array JSON en una tabla Markdown, usa las herramientas relacionadas de abajo.
Preguntas frecuentes
› ¿Qué variante de Markdown usa la tabla?
Las tablas con barras verticales de GitHub Flavored Markdown (GFM), compatibles también con GitLab, Bitbucket, Notion, Obsidian, Docusaurus, MkDocs y la mayoría de los generadores de sitios estáticos. CommonMark puro no tiene sintaxis de tablas.
› ¿Qué pasa con las barras verticales y los saltos de línea dentro de las celdas?
Una barra vertical cerraría la celda, así que se escribe como \|. No se permiten saltos de línea dentro de una fila de la tabla, así que se convierten en etiquetas <br>, que GitHub y la mayoría de los visores muestran como salto de línea.
› ¿Por qué se alinean las columnas en chino, japonés o coreano?
Con Alinear columnas activado, las celdas se rellenan según el ancho de visualización: los caracteres anchos de Asia oriental cuentan como dos columnas, así que el Markdown queda alineado en un editor de fuente monoespaciada. La tabla renderizada se ve igual en ambos casos.
› ¿Puedo convertir TSV copiado de Excel o Google Sheets?
Sí. Las celdas copiadas de una hoja de cálculo se separan con tabuladores y el delimitador se detecta automáticamente. También puedes elegir Tabulador explícitamente.