Generador de tablas Markdown
Edita una tabla en una cuadrícula, o pégala desde una hoja de cálculo, CSV o TSV, y cópiala como tabla Markdown de GitHub con columnas bien alineadas.
Funciona en tu navegador; nada de lo que escribes sale de tu dispositivo
Tablas de hasta unos pocos miles de celdas. Las tablas Markdown admiten una sola línea de texto por celda, así que los saltos de línea dentro de una celda se escriben como <br> y las barras verticales se escapan. La primera fila siempre es el encabezado, como exige GitHub.
Cómo crear una tabla Markdown
- Escribe en la cuadrícula o pega directamente las celdas copiadas de una hoja de cálculo. También puedes pegar CSV, TSV o una tabla Markdown existente en el cuadro y llenar la cuadrícula con ese texto.
- Agrega o quita filas y columnas, y elige alineación izquierda, centro o derecha para cada columna.
- Copia el Markdown y pégalo en tu README, issue, pull request o documento.
Cómo se escribe una tabla Markdown
Una tabla Markdown de GitHub es texto plano: una fila de encabezado, una fila de guiones que define la alineación y una línea por cada fila de datos, con las celdas separadas por barras verticales. Es el formato que GitHub muestra en READMEs, issues y pull requests, y muchas otras herramientas, como sitios de documentación y apps de notas, también lo entienden.
La cuadrícula contiene las celdas; la primera fila es el encabezado. Cada columna tiene una alineación. La izquierda se escribe :---, el centro :---:, la derecha ---: y la ausencia de alineación son guiones simples. El texto de las celdas se escapa cuando hace falta: una barra vertical pasa a ser \| y un salto de línea pasa a ser la etiqueta HTML <br>. Después la herramienta alinea las columnas con espacios para que el código se lea como una tabla, usando el ancho de cada carácter y no su tamaño en bytes, de modo que las letras con tilde también cuadren.
Pegar desde una hoja de cálculo es la forma más rápida de empezar. Las hojas de cálculo copian las celdas al portapapeles como texto separado por tabulaciones, con una línea por fila, y la cuadrícula lo lee directamente. Los archivos CSV y TSV funcionan igual a través del cuadro de pegado, con campos entre comillas y saltos de línea entre comillas incluidos. Si pegas una tabla Markdown existente, las celdas y las alineaciones se leen de vuelta en la cuadrícula para que puedas modificarlas.
Consejos
- ¿Tienes JSON en lugar de una hoja de cálculo? Conviértelo primero con JSON a CSV y pega aquí el resultado.
- Mira cómo se verá la tabla con Markdown a HTML.
- Para ir en sentido contrario, de una página web de vuelta a Markdown, usa HTML a Markdown.
Preguntas frecuentes
¿Cómo convierto una hoja de cálculo en una tabla Markdown?
Selecciona las celdas en Excel, Google Sheets o Numbers, cópialas y pégalas en cualquier celda de la cuadrícula. Las celdas de una hoja llegan como texto separado por tabulaciones, y la cuadrícula se llena a partir de la celda donde pegaste. También puedes pegar CSV o TSV en el cuadro sobre la cuadrícula y elegir Llenar la cuadrícula con este texto.
¿Cómo funcionan las alineaciones de columna?
La fila de guiones bajo el encabezado define la alineación: :--- es izquierda, :---: es centro, ---: es derecha y --- es la predeterminada. Elige la alineación de cada columna sobre su celda de encabezado.
¿Qué pasa con una barra vertical o un salto de línea en una celda?
Una barra vertical | terminaría la celda, así que se escribe como \|. Las tablas Markdown no admiten saltos de línea reales, así que un salto en una celda se escribe como <br>, que GitHub muestra como una línea nueva.
¿Por qué las columnas se rellenan con espacios?
El relleno alinea las columnas para que la tabla se lea bien como texto plano. No cambia cómo se muestra el resultado. Desmarca Alinear las columnas para obtener la forma más corta.
¿Puedo editar una tabla Markdown que ya tengo?
Sí. Pégala en el cuadro y elige Llenar la cuadrícula con este texto. La herramienta lee las celdas y las alineaciones y las coloca en la cuadrícula.
¿Se sube mi tabla a algún servidor?
No. La tabla se genera en tu navegador y nada sale de tu dispositivo.