Convertidor CSV a YAML

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

La conversión de CSV a YAML transforma datos tabulares separados por comas al formato YAML (YAML Ain't Markup Language). Cada fila del archivo CSV se convierte en una entrada de una secuencia YAML, y cada cabecera de columna se mapea a una clave en un mapeo YAML. El resultado es un documento legible por humanos, basado en indentación, que las herramientas de configuración y los pipelines de datos pueden analizar directamente sin archivos de esquema adicionales.

YAML se propuso por primera vez en 2001 y alcanzó su especificación actual (YAML 1.2) en 2009. Es el formato de configuración predeterminado para manifiestos de Kubernetes, archivos Docker Compose, playbooks de Ansible, flujos de trabajo de GitHub Actions y la mayoría de los sistemas CI/CD. Cuando tus datos de origen están en una hoja de cálculo o en una exportación de base de datos, convertir CSV a YAML es la forma más rápida de generar entradas de configuración, fixtures de datos iniciales o entradas de prueba para estos sistemas.

Un conversor correcto de CSV a YAML debe gestionar las reglas de análisis de RFC 4180: campos entrecomillados que contienen comas o saltos de línea, comillas dobles escapadas y delimitadores variables. En el lado YAML, las cadenas que parecen booleanos (yes, no, true, false), números o null deben entrecomillarse para evitar que los analizadores YAML las coaccionen a tipos no deseados. El conversor también debe gestionar contenido Unicode y producir salida UTF-8 válida, ya que YAML 1.2 requiere UTF-8 como codificación predeterminada.

¿Por qué usar un conversor de CSV a YAML?

Escribir YAML a mano a partir de datos de hojas de cálculo es tedioso y propenso a errores. Una indentación incorrecta o un carácter especial sin entrecomillar produce YAML no válido que rompe los despliegues de configuración o las importaciones de datos. Este conversor analiza los campos CSV, mapea las cabeceras a claves y genera salida YAML correctamente indentada y entrecomillada.

Casos de uso de CSV a YAML

Referencia de mapeo CSV a YAML

Cada elemento estructural de un archivo CSV tiene su equivalente directo en YAML.

CSV vs YAML

CSV es un formato plano separado por delimitadores sin información de tipo ni jerarquía. YAML es un superconjunto de JSON que usa indentación para el anidamiento, soporta múltiples tipos de datos y permite comentarios. La elección depende de lo que espere tu herramienta downstream.

Ejemplos de código

Ejemplos funcionales en Node.js, Python, Go y herramientas de línea de comandos. Cada uno lee la fila de cabecera del CSV como claves YAML, mapea cada fila de datos a una entrada de secuencia y gestiona el entrecomillado para valores con ambigüedad de tipo.

import { parse } from 'csv-parse/sync'
import { stringify } from 'yaml'

const csv = `name,age,city
Alice,30,Berlin
Bob,25,"New York"`

const records = parse(csv, { columns: true, skip_empty_lines: true })
console.log(stringify(records))
// → - name: Alice
// →   age: "30"
// →   city: Berlin
// → - name: Bob
// →   age: "25"
// →   city: New York

// Vanilla JS (no dependencies)
function csvToYaml(csv) {
  const [headerLine, ...dataLines] = csv.trim().split('\n')
  const headers = headerLine.split(',')
  return dataLines.map(line => {
    const values = line.split(',')
    return headers.map((h, i) => `  ${h}: ${values[i] || ''}`).join('\n')
  }).map(block => `- ${block.trimStart()}`).join('\n')
}

import csv, io, yaml

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

reader = csv.DictReader(io.StringIO(csv_string))
data = list(reader)

# default_flow_style=False produces block-style YAML
print(yaml.dump(data, default_flow_style=False, sort_keys=False))
# → - age: '30'
# →   city: Berlin
# →   name: Alice
# → - age: '25'
# →   city: New York
# →   name: Bob

# Preserve insertion order with sort_keys=False (Python 3.7+)
# To type-cast numbers: data = [{k: int(v) if v.isdigit() else v ...}]

package main

import (
	"encoding/csv"
	"fmt"
	"gopkg.in/yaml.v3"
	"strings"
)

func main() {
	input := "name,age,city
Alice,30,Berlin
Bob,25,New York"
	r := csv.NewReader(strings.NewReader(input))
	records, _ := r.ReadAll()
	headers := records[0]

	var data []map[string]string
	for _, row := range records[1:] {
		entry := make(map[string]string)
		for i, h := range headers {
			entry[h] = row[i]
		}
		data = append(data, entry)
	}

	out, _ := yaml.Marshal(data)
	fmt.Println(string(out))
	// → - age: "30"
	// →   city: Berlin
	// →   name: Alice
	// → - age: "25"
	// →   city: New York
	// →   name: Bob
}

# Using yq (https://github.com/mikefarah/yq)
# yq reads CSV with --input-format=csv
yq --input-format=csv --output-format=yaml '.' data.csv

# Using Miller (mlr) — converts between CSV, JSON, YAML, and more
mlr --icsv --oyaml cat data.csv

# Python one-liner for quick conversion
python3 -c "
import csv, sys, yaml
data = list(csv.DictReader(sys.stdin))
print(yaml.dump(data, default_flow_style=False, sort_keys=False))
" < data.csv

Preguntas frecuentes