Por qué usar un generador de tablas Markdown
Las tablas Markdown son texto plano. Cada fila es una línea, las celdas se separan con barras verticales y debajo del encabezado va una fila divisoria de guiones. Se leen con facilidad, pero escribirlas es lento, y mantener las columnas alineadas a mano es tedioso. Un valor más largo te obliga a rellenar de nuevo todas las demás filas.
Este generador de tablas Markdown te da una cuadrícula para escribir, como una pequeña hoja de cálculo, y escribe el Markdown por ti. También lee datos que ya tienes: celdas copiadas de Excel o Google Sheets, texto CSV o una tabla Markdown existente.
Cómo usar la cuadrícula
- Escribe en cualquier celda. La primera fila es el encabezado y se muestra en negrita.
- Añadir fila y Añadir columna amplían la tabla. Los botones pequeños con una x junto a cada fila y encima de cada columna la eliminan.
- Pulsa Intro para bajar una fila. En la última fila, Intro añade una nueva.
- Alineación: el selector encima de cada columna la fija en Predeterminada, Izquierda, Centro o Derecha.
- Pega un bloque de celdas en cualquier celda para llenar la cuadrícula desde ese punto.
- Pegar datos abre un cuadro para celdas de hoja de cálculo, CSV o una tabla Markdown. Pulsa Cargar en la cuadrícula para sustituir la cuadrícula por esos datos. Los CSV separados por punto y coma, como los que exporta Excel en español, también se reconocen.
- Intercambiar filas y columnas gira la tabla.
- Ejemplo carga una tabla de muestra y Borrar empieza de nuevo con una cuadrícula vacía de 3 por 3.
El Markdown aparece debajo de la cuadrícula. Alinear columnas rellena cada celda con espacios para que la tabla se lea bien como texto plano. Desactívalo para obtener el resultado más corto. Copiar lo pone en tu portapapeles y Descargar guarda un archivo .md.
Ejemplo
Una pequeña tabla de precios con la primera columna alineada a la izquierda, los precios a la derecha y el número de usuarios centrado:
| Plan | Price | Users |
| :------- | ----: | :-------: |
| Free | $0 | 1 |
| Team | $12 | 10 |
| Business | $30 | Unlimited |Los dos puntos de la fila divisoria fijan la alineación: dos puntos a la izquierda significan izquierda, a la derecha significan derecha y a ambos lados significan centro. Con Alinear columnas desactivado, la misma tabla se escribe sin relleno:
| Plan | Price | Users |
| :-- | --: | :-: |
| Free | $0 | 1 |
| Team | $12 | 10 |
| Business | $30 | Unlimited |Las dos versiones se ven igual una vez renderizadas. La rellenada es más fácil de leer y editar en un archivo de texto. La compacta es más corta y genera diffs más pequeños cuando cambia un solo valor.
Caracteres especiales en las celdas
Una barra vertical dentro de una celda la cerraría antes de tiempo, así que el generador la escapa. Un salto de línea dentro de una celda, que puede venir de un pegado desde una hoja de cálculo, se convierte en <br>:
| Command | Meaning |
| -------------- | ----------- |
| a \| b | pipe output |
| line1<br>line2 | two lines |El resto del Markdown dentro de una celda, como **negrita**, un enlace o código en línea, se conserva y se renderiza con normalidad.
Al rellenar, los caracteres chinos, japoneses y coreanos cuentan como dos columnas de ancho, porque así se ven en la mayoría de las fuentes monoespaciadas. Eso mantiene las barras alineadas en los editores que usan esas fuentes. Las letras con tilde y la ñ cuentan como un solo carácter, así que una columna con “Población” o “A Coruña” queda tan bien alineada como una en inglés.
Dónde funcionan las tablas Markdown
GitHub, GitLab, Bitbucket, Obsidian, Reddit y la mayoría de los generadores de sitios estáticos admiten esta sintaxis de tablas. Viene de GitHub Flavored Markdown. El Markdown original no tenía tablas, así que un renderizador muy antiguo puede mostrar las barras sin procesar.
Consejos
- Haz tablas estrechas. Las frases largas van mejor en párrafos. Una tabla de 3 a 6 columnas cortas es la más fácil de leer en el móvil.
- Empieza desde una hoja de cálculo cuando los datos ya estén en una. Copia el rango, pégalo en la primera celda y ajusta la alineación.
- Para ordenar una tabla dentro de un documento más largo, pega el documento entero en el formateador Markdown. Rellena las tablas de la misma forma.
- Para datos que deben acabar en JSON y no en una tabla, usa el convertidor de CSV a JSON.
- Para convertir en Markdown una tabla HTML de una página web, usa el convertidor de HTML a Markdown.
Otras formas de crear tablas Markdown
- VS Code: extensiones como Markdown All in One dan formato a las tablas en su sitio cuando das formato al documento.
- Pandoc puede convertir un CSV o una exportación de hoja de cálculo en una tabla Markdown desde la línea de comandos.
- Google Sheets: no tiene exportación a Markdown integrada, pero copiar las celdas y pegarlas aquí lleva unos segundos.
Todo ocurre en tu navegador. Los datos que pegas no se envían a ningún sitio.