Tabla HTML a Markdown: por qué desaparece la primera columna

Contenido
Si alguna vez has copiado una tabla de Wikipedia o de un portal de datos públicos, o una tabla HTML exportada desde Excel, y la has convertido a Markdown, puede que hayas visto un resultado extraño.
La primera celda de cada fila —normalmente donde va el nombre del elemento— aparece completamente vacía, o los valores del resto de las celdas se desplazan una posición y la última celda queda en blanco.
El código HTML de la tabla original parece correcto y no tiene errores de escritura, pero solo el resultado de la conversión falla, así que no es fácil encontrar la causa. Este fenómeno no se debe a una conversión defectuosa: hay una causa comprobable que proviene de una etiqueta dentro del código de la tabla.
Resumen ① Este convertidor solo lee la primera fila de la tabla como fila de encabezado; en todas las filas siguientes cuenta únicamente las etiquetas
<td>como valores. ② Si la primera celda de una fila del cuerpo está marcada con<th scope="row">, esa celda no se cuenta como valor y se omite por completo. ③ El hueco omitido se rellena con una celda vacía no al principio, sino al final de la fila, por lo que todos los demás valores parecen desplazados una posición.
Problema: copiaste la tabla tal cual y desaparece la primera celda
Las tablas creadas pensando en la accesibilidad, como las tablas estadísticas por país de Wikipedia o las tablas comparativas de organismos públicos, usan <th scope="row"> en lugar de <td> en la primera celda de cada fila. Es una forma de marcado que permite que los lectores de pantalla lean primero esa celda como el título de la fila correspondiente.
En pantalla normalmente solo se ve con una tipografía ligeramente en negrita, así que no se distingue a simple vista de una celda normal. Por eso, al copiar la tabla, pegamos el código tal cual sin comprobar si esa celda es <td> o <th>.
Causa: el convertidor lee de forma distinta la fila de encabezado y las filas del cuerpo
En la primera fila de la tabla (<tr>), este convertidor no distingue entre <th> y <td>: lee todo como celdas de encabezado. En cambio, en todas las filas siguientes solo lee las etiquetas <td> como valores y no cuenta las <th> en absoluto.
Por eso, si al principio de una fila del cuerpo hay un <th scope="row">, el texto de esa celda no aparece en el resultado. Las celdas que faltan se rellenan con celdas vacías no al principio, sino al final de la fila, de modo que todos los valores restantes parecen desplazados una posición hacia la izquierda.
Solución: revisa la posición de th en el código original antes de pegar
Antes de mover la tabla, haz clic con el botón derecho sobre ella y elige «Inspeccionar». Se abrirá el código de esa <table> en las herramientas de desarrollo. Busca si dentro de las filas posteriores a la primera <tr> hay alguna etiqueta que empiece por <th.
Si la hay, basta con cambiar antes de pegar solo ese <th ...> y su cierre </th> por <td> y </td>. Solo cambias el nombre de la etiqueta y dejas el texto interior tal cual, así que no hace falta rehacer la tabla entera.
Compruébalo con nuestro Convertidor de Tabla HTML a Markdown. En lugar de buscar y cambiar las etiquetas a mano, puedes pegar el código de la tabla tal cual y revisar primero en el resultado si cada fila tiene el mismo número de celdas que la fila de encabezado y si la primera celda no está vacía.
Gratis · sin registro · pega el código de tu tabla HTML y conviértelo al instante en una tabla Markdown

Puntos donde suele atascarse la gente
| Situación | Lo que ocurre en realidad |
|---|---|
La primera celda de una fila del cuerpo está marcada con <th scope="row"> | El texto de esa celda desaparece del resultado y el resto de valores se desplaza una posición |
La celda está unida con rowspan y en esa fila no existe | Por la misma razón, el final se rellena con una celda vacía y parece desplazado |
| La celda contiene el símbolo de barra vertical | Se escapa automáticamente para que no se confunda con el separador de la tabla |
| La tabla empieza con datos y no tiene fila de encabezado | La primera fila se usa tal cual como encabezado, así que una fila de datos acaba incorrectamente como título |
En resumen
- Este convertidor solo lee la primera fila de la tabla como fila de encabezado; en todas las filas siguientes cuenta únicamente las etiquetas
<td>como valores. - Si la primera celda de una fila del cuerpo está escrita con
<th scope="row">, esa celda desaparece y el resto de valores parece desplazado una posición. - Las celdas omitidas por
rowspantambién provocan el mismo desplazamiento de las celdas siguientes. - Puedes evitarlo revisando con las herramientas de desarrollo la posición de
<then el código original antes de pegar y cambiándolo por<td>. - Después de convertir, es una buena costumbre comprobar que cada fila tenga el mismo número de celdas que la fila de encabezado.
Gratis · sin registro · pega el código de tu tabla HTML y conviértelo al instante en una tabla Markdown
Preguntas frecuentes
Copié una tabla, ¿cómo compruebo si el original tiene th?
En la página donde está la tabla, haz clic con el botón derecho sobre ella y elige «Inspeccionar». Se abrirá el código de esa <table> en las herramientas de desarrollo. Dentro de ese código, busca a partir de la segunda <tr> si hay alguna etiqueta que empiece por <th.
¿Las tablas exportadas desde Excel o Google Sheets tienen el mismo problema?
Las tablas exportadas con la opción de guardar como página web de Excel o Google Sheets suelen usar solo <td> en todas las celdas. Los casos en los que <th> aparece mezclado en las filas del cuerpo se dan sobre todo en tablas maquetadas a mano pensando en la accesibilidad, como las de Wikipedia o las estadísticas de organismos públicos.
¿Esta herramienta también divide y reconstruye las celdas combinadas con colspan y rowspan?
No. En las celdas combinadas el texto queda en una sola celda y las demás se rellenan o se recortan automáticamente. La sintaxis de las tablas Markdown no puede expresar la combinación de celdas, así que hay que deshacer las combinaciones en el original antes de pegar.
Este artículo está adaptado de nuestro original en coreano. Leer el original en coreano