Markdown · Tablas · Formato

Generador de Tablas de Markdown

Crea tablas de Markdown en un editor estilo hoja de cálculo. Pega desde Excel o Sheets. Vista previa en vivo.

Salida de Markdown
Vista previa en vivo
Publicidad

Sobre el Generador de Tablas de Markdown

Crea tablas de Markdown bien formateadas editando las celdas directamente. Agrega filas, agrega columnas, define la alineación de las columnas, pega datos en CSV o TSV y copia el código Markdown resultante. Sirve para documentación, README de GitHub, entradas de blog y cualquier lugar donde se rendericen las tablas de Markdown. Todo se ejecuta localmente en tu navegador; no se sube nada.

Qué son las tablas de Markdown

Las tablas de Markdown son una extensión no estándar pero casi universal de la especificación de Markdown. Usan barras verticales (|) para separar las columnas y guiones (-) para marcar la fila separadora del encabezado:

| Nombre | Rol | Estado |
| --- | --- | --- |
| Alice | Diseñadora | Activo |
| Bob | Desarrollador | Activo |

Todos los renderizadores de Markdown importantes (GitHub, GitLab, Bitbucket, Discord, Slack, Notion, Obsidian, MkDocs, Jekyll, Hugo) admiten esta sintaxis. La especificación original de Markdown de John Gruber no incluye tablas, así que técnicamente las tablas de Markdown son una extensión llamada «GFM tables» (GitHub Flavored Markdown), pero la sintaxis está tan extendida que en la práctica es estándar.

Escribir tablas de Markdown a mano es tedioso porque el ancho de las columnas importa para que el código se lea bien. Una tabla con celdas de 3 caracteres junto a celdas de 30 se ve fea cuando las barras no quedan alineadas, aunque a los renderizadores no les importe. El Generador de Tablas de Markdown se encarga del formato de forma automática y produce un código que se renderiza bien y se lee limpio.

Casos de uso reales

Documentar parámetros de API. Casi todos los README y las documentaciones de API tienen una tabla de parámetros: nombre, tipo, descripción, valor por defecto. El generador las crea en segundos.

Tablas comparativas en entradas de blog. Las comparaciones «Herramienta X vs Herramienta Y» se renderizan como tablas. Las tablas de Markdown funcionan en Substack, Medium (con algo de esfuerzo), Ghost, Hashnode y dev.to.

Tablas de precios en la documentación de productos. Nombre del plan, costo mensual, costo anual, funciones incluidas. Las tablas organizan esto mucho mejor que la prosa.

Tablas de referencia de configuración. Nombre del ajuste, tipo, valor por defecto, descripción. Es el formato estándar para herramientas, bibliotecas y frameworks.

Reportes de estado y resúmenes de proyecto. Tarea, responsable, estado, fecha de entrega. Las tablas hacen documentos de estado fáciles de revisar de un vistazo.

Resúmenes de resultados de pruebas. Nombre de la prueba, esperado, real, aprobado/fallado. La mayoría de los sistemas de CI/CD renderizan bien las tablas de Markdown en los reportes de pruebas.

Matrices de comparación de funciones. Función, plan gratis, plan pro, plan enterprise. Las tablas son el único formato sensato para esto.

Documentación de esquemas para bases de datos o API. Nombre del campo, tipo, admite nulos, descripción. Las tablas largas funcionan bien. Las tablas de Markdown no tienen un tamaño máximo.

Pegar desde hojas de cálculo

El generador acepta datos pegados en CSV (separado por comas) y TSV (separado por tabulaciones). Cuando copias un rango desde Excel, Google Sheets o Numbers, el portapapeles contiene TSV por defecto. Pega en el generador y las filas y columnas se analizan de forma automática.

Esto hace que el flujo de trabajo típico sea muy rápido: crea una tabla en tu hoja de cálculo (donde editar muchas celdas es cómodo), copia, pega en el generador, copia la salida de Markdown y pégala en tu documento. Tres pegados en total.

Para CSV con campos entre comillas, el generador maneja el escapado estándar de CSV: campos entre comillas, comillas escapadas dentro de comillas, comas incrustadas dentro de campos entre comillas. Los casos límite (saltos de línea literales dentro de campos entre comillas, un BOM al inicio del archivo) pueden necesitar una limpieza antes de pegar.

Alineación de columnas

Las tablas de Markdown admiten tres opciones de alineación a través de la sintaxis de la fila separadora del encabezado.

Alineación a la izquierda (por defecto): | --- |. Equivale a guiones simples. La mayoría de los renderizadores la tratan como izquierda.

Alineación al centro: | :---: |. Los dos puntos a ambos lados de los guiones indican alineación centrada.

Alineación a la derecha: | ---: |. Los dos puntos a la derecha de los guiones indican alineación a la derecha. Útil para columnas numéricas.

La alineación en el resultado renderizado depende del renderizador. GitHub, GitLab, Hashnode y la mayoría de los procesadores de Markdown modernos respetan los marcadores de alineación. Los procesadores más antiguos o más simples (algunos CMS heredados) pueden ignorarlos y usar la alineación a la izquierda por defecto en todo.

Para las columnas numéricas, la alineación a la derecha hace que los valores queden alineados en el punto decimal y es mucho más fácil de revisar. Para los encabezados de columna, la alineación al centro se ve equilibrada. Para todo lo demás, la alineación a la izquierda por defecto está bien.

Errores frecuentes

Barras verticales dentro del contenido de una celda. Una barra vertical literal dentro de una celda rompe la sintaxis de la tabla: el renderizador cree que es un separador de columnas. Escápala como \| o usa la entidad HTML |. El generador se encarga de esto en la salida.

Saltos de línea dentro de las celdas. Las tablas de Markdown no admiten contenido de celda en varias líneas directamente. Para incluir un salto de línea dentro de una celda, usa la etiqueta HTML <br>. El editor de celdas del generador acepta <br> y lo conserva en la salida.

Fila de encabezado vacía. Las tablas de Markdown exigen una fila de encabezado aunque todos tus datos sean del cuerpo. Si no tienes encabezados con sentido, usa encabezados de una sola letra o vacíos. La fila de encabezado es estructural; el renderizado ignora su contenido si la dejas en blanco.

Conteos de columnas que no coinciden. Cada fila necesita el mismo número de celdas separadas por barras. El generador lo exige. Las tablas escritas a mano a veces tienen filas con distinto número de columnas, algo que la mayoría de los renderizadores rechazan en silencio.

HTML dentro de las celdas. La mayoría de los renderizadores de Markdown permiten HTML básico dentro de las celdas: <strong>, <em>, <a>, <br>, a veces <code>. Algunos CMS quitan el HTML por seguridad; comprueba qué admite tu renderizador objetivo.

Formato de Markdown dentro de las celdas. El formato de Markdown en línea funciona en la mayoría de los renderizadores: **bold**, *italic*, `code`, [link](url). El Markdown de nivel de bloque (encabezados, listas, citas) no funciona dentro de las celdas.

Tablas de Markdown vs tablas HTML vs exportaciones de hojas de cálculo

Tablas de Markdown. Lo mejor para documentación, entradas de blog y cualquier lugar donde Markdown sea el formato de origen. Sintaxis ligera, amigable con el control de versiones, se renderiza de forma consistente.

Tablas HTML. Necesarias cuando requieres combinar celdas (colspan, rowspan), elementos anidados o estilos. Más extensas pero más flexibles. Usa tablas HTML dentro de documentos de Markdown cuando la sintaxis de las tablas de Markdown no alcanza.

Exportaciones de hojas de cálculo (CSV, TSV). Lo mejor para el intercambio de datos, la automatización y el análisis. No se renderizan directamente en la mayoría de los contextos; hay que convertirlas antes de mostrarlas.

Para documentación, las tablas de Markdown suelen ser la respuesta correcta. Recurre a las tablas HTML cuando necesites combinar celdas o aplicar estilos.

Cómo funciona la herramienta

El generador presenta una cuadrícula editable donde rellenas las celdas, agregas filas y columnas y defines la alineación de las columnas. A medida que editas, el código Markdown se actualiza en vivo. Haz clic en «Copiar markdown» para copiar el código al portapapeles.

El CSV o TSV pegado se analiza detectando el delimitador (tabulación si está presente, coma si no) y dividiendo las filas en los saltos de línea. Los campos entre comillas se manejan según las convenciones de RFC 4180. Las tabulaciones dentro de campos entre comillas se conservan como tabulaciones literales en el contenido de la celda.

La salida es Markdown bien formateado: el ancho de las columnas normalizado para que el código se lea bien, los marcadores de alineación incluidos, los caracteres especiales escapados. El resultado se renderiza de forma idéntica en todos los procesadores de Markdown importantes.

Consejos de flujo de trabajo

Crea en una hoja de cálculo, formatea en el generador. Editar tablas es mucho más rápido en la vista de cuadrícula de una hoja de cálculo que en un editor de Markdown. Créala ahí, pega, formatea, copia y pega en tu documento.

Alinea a la derecha las columnas numéricas. La alineación a la izquierda por defecto hace que los datos numéricos sean más difíciles de revisar. Los dos segundos que cuesta definir la alineación se pagan en legibilidad.

Mantén las tablas angostas cuando puedas. Una tabla más ancha que el ancho de la página renderizada genera barras de desplazamiento horizontales o un ajuste de texto que rompe la estructura visual. Para datos anchos, evalúa si una lista o varias tablas más pequeñas comunicarían mejor.

Usa formato de código para el código en las celdas. Envuelve los ejemplos de código en comillas invertidas para que se rendericen en monoespaciado. Si no, el renderizador aplica su fuente de cuerpo y el código parece prosa.

Preguntas frecuentes

¿Por qué no se renderiza mi tabla en mi CMS?

Algunos procesadores de Markdown no admiten tablas (versiones antiguas, implementaciones muy mínimas). Comprueba si tu CMS usa GitHub Flavored Markdown (que incluye tablas) u otra variante. Si no, quizá necesites tablas HTML.

¿Puedo tener saltos de línea dentro de una celda?

Usa la etiqueta HTML <br> dentro de la celda. Las tablas de Markdown no admiten celdas de varias líneas de forma nativa, pero <br> funciona en la mayoría de los renderizadores.

¿Cómo incluyo una barra vertical en el contenido de una celda?

Escápala como \| o usa la entidad HTML &#124;. El generador se encarga de esto de forma automática cuando escribes una barra vertical en una celda.

¿Puedo importar una tabla de Markdown existente para editarla?

Pega el código Markdown en el área de entrada; el generador lo vuelve a convertir en la cuadrícula editable. Desde ahí puedes modificar celdas, agregar filas o columnas, cambiar la alineación y volver a exportar.

¿Admite combinar celdas (colspan/rowspan)?

No. La sintaxis de las tablas de Markdown no admite combinar celdas. Para tablas con celdas combinadas, cambia a la sintaxis de tablas HTML.

¿Funciona el formato de Markdown en línea dentro de las celdas?

Sí, en la mayoría de los renderizadores. La negrita, la cursiva, el código en línea y los enlaces funcionan dentro de las celdas. El Markdown de nivel de bloque (encabezados, listas, citas) no.

Relacionados

Publicidad

Aprende más sobre el generador de tablas de Markdown