La sintaxis de una tabla Markdown
Una tabla en Markdown se arma con pipes (|) que separan las columnas y guiones (---) que separan el encabezado del cuerpo. La primera fila son los títulos de columna, la segunda es la fila separadora obligatoria y las siguientes son los datos. Esta herramienta se encarga de esa estructura por vos: contás las columnas, alineás los pipes y agregás la fila separadora sin que tengas que tipear un solo guion.
Alineación de columnas
La alineación se controla con dos puntos en la fila separadora. Sin dos puntos (---) el renderizador usa su alineación por defecto, normalmente a la izquierda. Con dos puntos a la izquierda (:---) alineás a la izquierda de forma explícita, con dos puntos a ambos lados (:---:) centrás y con dos puntos a la derecha (---:) alineás a la derecha. Elegí la que quieras y la herramienta la aplica a todas las columnas.
Uso en GitHub, README y documentación
Las tablas Markdown son el estándar para mostrar datos tabulares en README de GitHub, issues, pull requests y wikis, además de la mayoría de los generadores de sitios estáticos. Convertir un CSV a Markdown te deja pegar un dataset exportado de una hoja de cálculo directamente en tu documentación, sin capturas de pantalla ni HTML a mano. Como es texto plano, queda versionado en Git y se ve bien en cualquier visor.
Comillas, comas y saltos de línea
El CSV es traicionero cuando un campo contiene el propio separador. El estándar resuelve esto envolviendo el campo entre comillas dobles: todo lo que esté adentro, incluidas comas y saltos de línea, se considera texto. Una comilla doble literal dentro del campo se escribe duplicada (""). La herramienta implementa este análisis, así que un valor como "García, Ana" queda en una sola celda y no se parte en dos columnas.
Errores comunes a tener en cuenta
El principal es el pipe: si un dato contiene |, hay que escaparlo como \| o la tabla se rompe. La herramienta lo hace automáticamente. Otro punto es que Markdown no admite saltos de línea reales dentro de una celda, por eso los reemplazamos por <br>. Por último, recordá que toda tabla Markdown necesita una fila de encabezado: si tu CSV no la tiene, desactivá la opción correspondiente y se generan encabezados genéricos.
Referencia: de CSV a Markdown
Un CSV mínimo con encabezado y su tabla Markdown equivalente:
| CSV | Markdown generado |
|---|---|
| |