Tablas en Markdown: de Excel o CSV a un PDF limpio

Por Fazt · Actualizada el 7 de octubre de 2026

Muchas veces una tabla es la razón de ser de un documento: la lista de precios para un cliente, el calendario de una formación o el anexo de datos de un informe. Las cifras suelen estar en una hoja de cálculo y el resultado tiene que ser un PDF. Markdown encaja muy bien entre ambos: sus tablas son texto plano que puedes editar y guardar con control de versiones, y se imprimen como tablas limpias y con bordes. Esta guía repasa la sintaxis, el paso desde Excel o CSV, cómo se comportan las tablas en papel y qué hacer cuando una se niega a aparecer.

La sintaxis en un minuto

El editor de Markdown sigue las reglas de tablas de GitHub Flavored Markdown: filas de celdas separadas por barras verticales.

| Plan     | Usuarios | Precio al mes |
| :------- | :------: | ------------: |
| Básico   | 1        | 9,00 €        |
| Equipo   | 10       | 49,00 €       |
| Empresa  | 50       | 199,00 €      |

La primera fila es el encabezado. Cada tabla tiene exactamente uno, que se imprime en negrita sobre un fondo sombreado.
La segunda fila es la de separación: al menos un guion por columna y exactamente tantas columnas como el encabezado.
Los dos puntos marcan la alineación: :--- a la izquierda (la opción por defecto), :---: centrado y ---: a la derecha. Alinea a la derecha precios y cantidades para que las cifras queden en columna.
Las barras de los extremos son opcionales, pero ayudan a detectar errores. Las columnas no tienen que estar alineadas en el texto fuente: el relleno solo es para tus ojos.
Deja una línea en blanco antes y después de la tabla.

Las reglas completas están en la especificación de GitHub Flavored Markdown.

Qué cabe dentro de una celda

Las celdas admiten Markdown en línea: negrita, cursiva, tachado, `código`, enlaces y llamadas a notas al pie. Hay tres cosas que vigilar:

Una barra vertical literal se escribe \|; si no, empieza una celda nueva. También dentro de las comillas invertidas.
Saltos de línea: cada fila ocupa una sola línea del texto fuente, así que pulsar Intro termina la fila. Usa <br> para partir una línea dentro de una celda.
Elementos de bloque como listas reales, varios párrafos o bloques de código no caben en una celda. Simula una lista corta con <br> o lleva una explicación larga a una nota al pie, que se imprime al final del documento.

| Paso | Comando | Notas |
| ---- | ------- | ----- |
| 1 | `npm install` | Descarga las dependencias |
| 2 | `sort registro.txt \| uniq` | Quita las líneas repetidas[^1] |
| 3 | `npm run build` | Tarda un minuto<br>El resultado va a **dist/** |

[^1]: La barra invertida mantiene la barra vertical dentro de la celda.

De Excel a una tabla Markdown

Abre el conversor de Excel a Markdown y suelta tu libro (.xlsx, .xlsm, .xlsb o el antiguo .xls). Se lee dentro de tu navegador, así que las cifras confidenciales no salen de tu equipo. El Markdown aparece en un cuadro de texto donde puedes editarlo antes de Copiar, Descargar .md o hacer clic en Abrir en el editor → PDF.

Esto es lo que hace la conversión con todo lo que puede contener una hoja de cálculo:

Hojas: cada hoja se convierte en su propia tabla, precedida de un título ## Nombre de la hoja cuando hay más de una. Las hojas vacías y las ocultas se omiten, igual que las filas y columnas ocultas: ocultar es una forma rápida de dejar fuera las columnas auxiliares.
Fila de encabezado: la primera fila solo se usa como encabezado si tiene un valor en todas las columnas. Si hay un título encima de la tabla, un título en celdas combinadas o una columna sin nombre, obtendrás una fila de encabezado vacía y tus encabezados reales acabarán en el cuerpo. Pon los nombres de las columnas en la fila 1 y dale nombre a todas.
Las filas vacías entre los datos se conservan como filas en blanco (| | | |). Bórralas en la hoja o en el cuadro de texto.
Las fórmulas salen como su último valor calculado. Un archivo creado por otro programa que nunca llegó a calcularlas puede mostrar celdas vacías: ábrelo en Excel y guárdalo una vez.
Los formatos de número se aplican: símbolos de moneda, porcentajes, separadores de miles y decimales aparecen con su formato (1,234.50 €, 15%), pero siempre con coma para los miles y punto para los decimales, aunque tu Excel muestre 1.234,50 €.
Las fechas y horas se escriben en formato ISO, como 2026-03-01 o 2026-11-20 14:30:00, aunque la celda muestre 01/03/2026.
Las celdas combinadas conservan su valor en la celda superior izquierda; las que cubrían quedan vacías.
Lo que se pierde: negritas, colores, bordes y gráficos. Los hipervínculos conservan solo el texto visible, un salto de línea dentro de una celda se convierte en un espacio y caracteres como * se escapan, así que el texto que parece Markdown se imprime tal cual.

Todas las columnas salen alineadas a la izquierda. Antes de imprimir, cambia la fila de separación a ---: bajo las columnas numéricas.

Desde CSV

CSV es lo que exportan casi todas las herramientas: Google Sheets, Numbers, programas de contabilidad, bases de datos y las bases de datos de Notion. Suelta el archivo en el conversor de CSV a Markdown:

El separador se detecta solo: funcionan comas, punto y coma (habitual en los países que usan la coma decimal) y tabuladores.
Los valores entre comillas que contienen el separador se quedan en una sola celda, y las barras verticales se escapan como \|.
Un CSV es texto plano, así que los valores se conservan tal como están escritos: las fechas no cambian de formato y los ceros a la izquierda se mantienen (0012). Las líneas en blanco se omiten.
La regla del encabezado es la misma que en Excel: la primera línea debe dar nombre a todas las columnas.
Los archivos que terminan en .tsv o .txt no se reconocen. Cámbiales la extensión a .csv antes de soltarlos.

¿Quieres las fechas como se ven en pantalla y no en formato ISO? Guarda esa hoja como CSV desde tu programa de hojas de cálculo, que normalmente escribe los valores tal como se muestran, y convierte el CSV.

Llevar la tabla a tu documento

Abrir en el editor → PDF sustituye lo que haya en el editor, algo ideal cuando el documento es solo la tabla. Para añadirla a un documento que ya tienes, haz clic en Copiar y pégala en su sitio, con una línea en blanco antes y después.

Cómo se imprimen las tablas

En el PDF, las tablas ocupan todo el ancho del texto, con bordes finos, la fila de encabezado sombreada y una letra algo más pequeña que la del cuerpo.

Las tablas largas continúan en las páginas siguientes y una fila nunca se parte entre dos páginas. Con Descargar PDF, la fila de encabezado se repite al principio de cada página (en Chrome, Edge y Firefox). El PDF rápido guarda las páginas como imágenes y no la repite.
Sombreado del encabezado: si sale en blanco, activa Gráficos de fondo en el diálogo de impresión.
Tablas anchas: las columnas se estrechan y el texto se reparte en varias líneas, pero una URL, un código o una palabra larga sin espacios no se puede partir: empuja la tabla más allá del margen derecho y el PDF la corta. Si una tabla se sale en la vista previa, en papel también.
Orientación: no hay opción horizontal. Las páginas son A4 o Letter (carta), en vertical.

Para que quepa una tabla ancha, prueba esto por orden: baja el Tamaño de letra en el panel Estilo (de 9 a 14 pt; afecta a todo el documento), pon los Márgenes en Estrechos (12 mm en lugar de 20), cambia las URLs largas por un texto de enlace corto como [informe](https://…), abrevia los nombres de las columnas y explícalos debajo de la tabla y, como último recurso, divide la tabla en dos o intercambia filas y columnas. Para que una tabla grande empiece en una página nueva, pon  en una línea propia justo antes.

Cuatro recetas

Comparativa

Opciones en columnas y criterios en filas: tres o cuatro opciones caben en una página vertical.

| | Proveedor A | Proveedor B | Proveedor C |
| --- | :---: | :---: | :---: |
| Precio por unidad | 4,20 € | 3,95 € | 4,10 € |
| Entrega | 3 días | 10 días | 5 días |
| Devolución gratuita | No | No | Sí |
| **Veredicto** | El más rápido | El más barato | **Mejor relación calidad-precio** |

Lista de precios

Alinea los precios a la derecha, pon el total en negrita y lleva las condiciones a una nota al pie.

| Servicio | Unidad | Precio |
| --- | --- | ---: |
| Auditoría web | por sitio | 450,00 € |
| Redacción de textos | por página | 120,00 € |
| Mantenimiento[^1] | al mes | 90,00 € |
| **Total del primer mes** | | **660,00 €** |

[^1]: Permanencia mínima de tres meses.

Calendario

Las horas en la primera columna y los días arriba; <br> mantiene una entrada de dos líneas en una sola celda.

| Hora | Lunes | Martes |
| --- | --- | --- |
| 09:00 | Reunión de arranque | Taller: modelo de datos |
| 11:00 | Entrevistas<br>Salas 2 y 3 | Continuación del taller |
| 14:00 | Visita a las instalaciones | Cierre y próximos pasos |

Anexo de datos

Deja un resumen en el cuerpo y los datos completos al final, tras un salto de página, donde más se agradece que el encabezado se repita.

<!-- pagebreak -->

## Anexo A. Ventas mensuales por región

| Mes | Norte | Sur | Total |
| --- | ---: | ---: | ---: |
| Enero | 12.400 | 9.800 | 22.200 |
| Febrero | 11.950 | 10.300 | 22.250 |

Cuándo una tabla no es la herramienta adecuada

Celdas que necesitan párrafos o listas: dale a cada elemento un título ### con una lista debajo.
Una sola columna de valores es, simplemente, una lista.
Más de siete u ocho columnas, o miles de filas: resume y comparte la hoja de cálculo aparte.
Maquetación, como bloques de texto uno al lado del otro: las tablas son para datos.

Solución de problemas

La tabla aparece como texto con barras. Cuenta las columnas: la fila de separación necesita exactamente tantas celdas como el encabezado, cada una con al menos un guion. Comprueba también que la tabla no esté sangrada cuatro espacios (se convertiría en un bloque de código) ni pegada a un elemento de lista sin línea en blanco, que la absorbe.
Faltan datos en una fila. Las celdas que superan el número de columnas del encabezado se descartan sin avisar; las filas más cortas se completan con celdas vacías. El culpable habitual es una | sin escapar en el texto.
La tabla se corta a la mitad y el resto se imprime como líneas con barras: hay una línea en blanco dentro de la tabla.
Una frase se ha convertido en una fila. El texto escrito en la línea siguiente a una tabla se lee como otra fila. Añade una línea en blanco.
Parte de una celda parece una fórmula. El editor muestra como LaTeX lo que va entre signos de dólar, así que una celda como entre 5 $ y 10 $ se convierte en una fórmula. Escapa el primer signo: 5 \$.
La tabla convertida tiene el encabezado vacío. La fila 1 de la hoja era un título o tenía una celda vacía. Corrige la hoja y vuelve a convertir, o borra la primera línea vacía y las filas de título y sube el encabezado real por encima de la línea ---.
Algunos códigos han cambiado. La tipografía inteligente convierte -- en un guion largo (–) y las comillas rectas en curvas. Pon los códigos de producto y los comandos entre comillas invertidas para que se queden tal cual.

La guía de Markdown recoge todo lo demás que admite el editor.