Convertidor CSV a Markdown

¿Qué es la conversión de CSV a Markdown?

Convertir CSV a una tabla Markdown es una tarea habitual para desarrolladores. CSV (valores separados por comas) almacena datos tabulares como texto plano, con cada fila en su propia línea y los campos separados por un delimitador como una coma o un tabulador. Es el formato de exportación predeterminado de hojas de cálculo, clientes SQL y herramientas de analítica. Los archivos CSV son compactos y fáciles de generar, pero no tienen ningún mecanismo integrado para controlar cómo se muestran los datos. Un archivo CSV abierto en un editor de texto es un bloque de cadenas delimitadas por comas, legible por máquinas pero difícil de leer para las personas.

Las tablas Markdown resuelven este problema de legibilidad. Están definidas por la especificación GitHub Flavored Markdown (GFM) y son compatibles con GitHub, GitLab, Bitbucket, Notion, Obsidian y generadores de sitios estáticos como Hugo y Jekyll. En cualquier lugar donde se procese Markdown, se renderizan como tablas HTML limpias. La sintaxis usa el carácter barra vertical para separar columnas y una fila separadora obligatoria de guiones entre la fila de encabezado y las filas del cuerpo.

Convertir CSV a una tabla Markdown implica envolver cada fila en la sintaxis delimitada por barras verticales e insertar la fila separadora después del encabezado. La primera fila del CSV se convierte en el encabezado de la tabla, y cada fila siguiente se convierte en una fila del cuerpo. Necesitas esto siempre que pegues datos estructurados en un README, la descripción de un pull request, una página wiki o cualquier sistema de documentación Markdown.

¿Por qué usar esta herramienta?

Este conversor analiza tu CSV en el navegador, genera la tabla Markdown al instante y nunca transmite tus datos a un servidor.

Casos de uso de CSV a Markdown

Referencia de sintaxis de tablas Markdown

Las tablas Markdown siguen la especificación GitHub Flavored Markdown (GFM). Toda tabla requiere una fila de encabezado, una fila separadora y una o más filas de cuerpo. La fila separadora controla la alineación de las columnas.

CSV vs tabla Markdown

Ambos formatos representan datos tabulares como texto plano. CSV es para máquinas y pipelines de datos; las tablas Markdown son para personas que leen documentación.

Ejemplos de código

Los siguientes ejemplos muestran cómo convertir CSV a una tabla Markdown de forma programática en distintos lenguajes. Cada uno produce una tabla GFM válida.

const csv = `name,age,city
Alice,30,Berlin
Bob,25,Tokyo`

const [headerLine, ...rows] = csv.trim().split('\n')
const headers = headerLine.split(',')

const separator = '| ' + headers.map(() => '---').join(' | ') + ' |'
const headerRow = '| ' + headers.join(' | ') + ' |'
const bodyRows = rows.map(row =>
  '| ' + row.split(',').join(' | ') + ' |'
)

const markdown = [headerRow, separator, ...bodyRows].join('\n')
// → | name | age | city |
// → | --- | --- | --- |
// → | Alice | 30 | Berlin |
// → | Bob | 25 | Tokyo |

import csv
import io

csv_string = """name,age,city
Alice,30,Berlin
Bob,25,Tokyo"""

reader = csv.reader(io.StringIO(csv_string))
rows = list(reader)
headers = rows[0]

lines = []
lines.append('| ' + ' | '.join(headers) + ' |')
lines.append('| ' + ' | '.join('---' for _ in headers) + ' |')
for row in rows[1:]:
    lines.append('| ' + ' | '.join(row) + ' |')

print('\n'.join(lines))
# → | name | age | city |
# → | --- | --- | --- |
# → | Alice | 30 | Berlin |
# → | Bob | 25 | Tokyo |

# With pandas (one-liner)
import pandas as pd
df = pd.read_csv(io.StringIO(csv_string))
print(df.to_markdown(index=False))

package main

import (
	"encoding/csv"
	"fmt"
	"strings"
)

func main() {
	input := "name,age,city\nAlice,30,Berlin\nBob,25,Tokyo"
	r := csv.NewReader(strings.NewReader(input))
	records, _ := r.ReadAll()

	headers := records[0]
	var lines []string

	lines = append(lines, "| "+strings.Join(headers, " | ")+" |")
	sep := make([]string, len(headers))
	for i := range sep {
		sep[i] = "---"
	}
	lines = append(lines, "| "+strings.Join(sep, " | ")+" |")

	for _, row := range records[1:] {
		lines = append(lines, "| "+strings.Join(row, " | ")+" |")
	}

	fmt.Println(strings.Join(lines, "\n"))
	// → | name | age | city |
	// → | --- | --- | --- |
	// → | Alice | 30 | Berlin |
	// → | Bob | 25 | Tokyo |
}

# Using Miller (mlr) — convert CSV to Markdown table
mlr --icsv --omarkdown cat data.csv
# → | name | age | city |
# → | --- | --- | --- |
# → | Alice | 30 | Berlin |

# Using csvtomd (pip install csvtomd)
csvtomd data.csv

# Using pandas in a one-liner
python3 -c "
import pandas as pd, sys
print(pd.read_csv(sys.argv[1]).to_markdown(index=False))
" data.csv

Preguntas frecuentes