Cómo hacer una tabla de Markdown en 60 segundos
Tres pasos para pasar de un documento en blanco a una tabla de Markdown que funciona. El camino a mano lleva un minuto. El camino de pegar desde una hoja de cálculo lleva diez segundos. Los dos dan el mismo resultado.
El camino a mano en 60 segundos
Decidiste que necesitas una tabla. Los datos están en tu cabeza o en una lista corta. La forma más rápida sin herramientas:
Paso 1. Escribe la fila de encabezado. Una barra vertical a cada lado de cada etiqueta de columna, más las barras de inicio y de cierre por seguridad:
| Nombre | Rol | Años |Paso 2. Escribe la fila separadora. Tres guiones o más por columna, entre barras:
| Nombre | Rol | Años |
|--------|-----|------|Agrega dos puntos si quieres alinear. :--- para la izquierda, ---: para la derecha, :---: para centrar.
Paso 3. Escribe las filas de datos. El mismo patrón de barras que el encabezado:
| Nombre | Rol | Años |
|:-------|:------------|-----:|
| Alicia | Ingeniera | 5 |
| Bruno | Diseñador | 3 |
| Carla | Gerente | 7 |Listo. La tabla se renderiza correctamente en GitHub, GitLab, Notion, Obsidian, MkDocs, Docusaurus, Reddit y Stack Overflow.
El camino de 10 segundos: pegar
La mayoría de las tablas ya existen en algún lado. Casi siempre en una hoja de cálculo. Aprovecha esos datos:
- En Excel o Google Sheets, selecciona el rango con los encabezados incluidos. Copia.
- Abre la herramienta Tabla de Markdown.
- Haz clic en «Pegar desde hoja de cálculo».
- Haz clic en «Copiar Markdown».
El portapapeles ya tiene el Markdown de la tabla. Pégalo donde se vaya a renderizar. Tiempo total: menos de diez segundos, sin escribir barras a mano ni contar guiones.
Ejemplo práctico — convertir un CSV real
Tienes un CSV parecido a este:
País,Capital,Población
Francia,París,67500000
España,Madrid,47600000
Italia,Roma,59600000Ábrelo en Excel o Sheets. Selecciona las cuatro filas, encabezado incluido. Copia. Pega en la herramienta Tabla de Markdown. El resultado:
| País | Capital | Población |
|---------|---------|------------:|
| Francia | París | 67.500.000 |
| España | Madrid | 47.600.000 |
| Italia | Roma | 59.600.000 |La alineación a la derecha en la columna Población se dedujo del contenido numérico. Ajústala a mano con el chip de alineación si quedó mal.
Los dos errores que más tiempo hacen perder
Error 1: alinear las barras a mano. Mucha gente pierde un minuto cuadrando las barras verticales en el origen para que la tabla se vea ordenada. El motor de renderizado lo ignora. |a|b| y | a | b | producen el mismo resultado. Sáltate ese paso, salvo que vayas a leer el propio código fuente.
Error 2: olvidar la fila separadora. Sin ella, el motor interpreta el bloque como párrafos. La solución es una sola línea de guiones entre el encabezado y los datos. La tabla se renderiza al instante.
Plantillas para tener a mano
Tres formatos habituales que vas a necesitar casi cada semana. Cópialos como punto de partida:
Comparación de tres columnas. Dos productos y una columna para el criterio:
| Criterio | Producto A | Producto B |
|:---------|:-----------|:-----------|
| | | |Referencia de configuración. El patrón estándar de la documentación:
| Opción | Tipo | Obligatorio | Valor por defecto | Descripción |
|:-------|:-----|:-----------:|:------------------|:------------|
| | | | | |Precios o números. Columnas numéricas alineadas a la derecha:
| Artículo | Cant. | Precio | Total |
|:---------|------:|-------:|------:|
| | | | |Para la referencia más a fondo sobre la sintaxis, las peculiaridades de la alineación y las diferencias de renderizado plataforma por plataforma, mira la guía completa de las tablas de Markdown.
Preguntas frecuentes
¿Cuántos guiones debe tener la fila separadora?
Los que quieras. Mínimo tres por columna. |---| funciona igual que |----------|. Los motores de renderizado ignoran la cantidad.
¿Necesito espacios dentro de las celdas?
No. |a|b| y | a | b | se renderizan igual. Los espacios son solo para que el código fuente se lea mejor.
¿Cuál es la forma más rápida de agregar una fila?
Copia la línea de arriba, pégala debajo y edita las celdas. Los límites de las barras ya coinciden con el encabezado. No hay que contar nada.
¿Cómo agrego una fila con celdas vacías?
Escribe las barras sin nada entre ellas: | | | |. Las celdas vacías se renderizan como celdas vacías, no como datos faltantes.
¿Puedo usar una herramienta de tablas de Markdown dentro de VS Code?
Sí. La extensión «Markdown Table» formatea y alinea las tablas al guardar. Para pegar desde Excel y convertir en un clic, usa la herramienta de TextKit en el navegador.
Seguir leyendo
Escrito por SAVI. Creamos las herramientas sobre las que escribimos. Prueba la herramienta Tabla de Markdown que usamos en este artículo.