El Markdown que recibes, y cómo dejarlo limpio
Última revisión
La conversión te da un archivo Markdown, no un documento terminado. Esto es una guía breve de campo sobre qué sale, de qué partes puedes fiarte y el corto número de ediciones que conviene hacer antes de que el archivo entre en un repositorio, un wiki o un almacén de notas.
7 min de lectura
Qué es exactamente la salida
El conversor emite GitHub Flavored Markdown, el dialecto que usan GitHub, GitLab, Obsidian, las importaciones de Notion y casi todos los generadores de sitios estáticos. Es CommonMark más unas cuantas añadiduras, de las cuales la que importa aquí son las tablas de barras verticales.
La elección es deliberada. CommonMark puro no tiene ninguna sintaxis de tablas, así que un conversor que apunte a él o descarta las tablas o emite HTML en crudo. Las tablas de GFM se leen bien como texto y se entienden casi en todas partes donde se entiende Markdown.
Qué sobrevive al viaje
| Títulos | Sí — como #, ##, ### a partir del tamaño relativo de fuente |
|---|---|
| Párrafos | Sí — a partir del espaciado vertical |
| Negrita y cursiva | Sí — a partir del peso y la inclinación reales de la fuente |
| Listas con viñetas | Sí — a partir de los glifos de viñeta iniciales |
| Listas numeradas | Sí — a partir de los numerales iniciales |
| Tablas | Las rectangulares simples, como tablas de barras GFM |
| Código en línea | Sí — a partir de fragmentos monoespaciados |
| Enlaces | Sí, cuando el PDF lleva una anotación de enlace real |
| Imágenes | No — la salida es solo texto y estructura |
| Notas al pie | Como texto al final de la página, sin enlazar |
| Matemáticas | Como los caracteres que las forman, no como LaTeX |
| Color y fuentes | No — Markdown no tiene forma de expresarlos |
Las cinco ediciones que merece la pena hacer siempre
Casi todos los archivos convertidos necesitan el mismo conjunto de pasadas. Cuestan un par de minutos y son la diferencia entre un archivo que puedes buscar y uno que puedes leer.
- Arregla la escalera de títulos. Los umbrales de tamaño producen niveles que son correctos localmente y desiguales en conjunto: un documento puede acabar con tres H1 y ningún H2. Repasa solo los títulos y renumera para que el anidamiento coincida con el esquema real del documento.
- Vuelve a unir los párrafos partidos. Un documento con interlineado generoso rompe párrafos en los finales de línea. Se leen como una pila de líneas cortas; únelas y borra las líneas en blanco sobrantes.
- Repara la separación silábica. El texto justificado con guiones al margen derecho deja palabras partidas entre líneas: "conver-" y luego "sión". Busca en el archivo un guion seguido de un salto de línea.
- Revisa todas las tablas. Cuenta las columnas del Markdown contra el original y comprueba la última fila: la fila final es la víctima más habitual. Una tabla que perdió la forma suele ser más rápida de volver a teclear que de reparar.
- Borra el mobiliario de página. Los encabezados y pies repetidos se detectan y se eliminan, pero un documento que los varía — un título de capítulo distinto en cada página — puede dejar restos.
Una nota sobre las tablas
Una tabla de barras de GFM necesita el mismo número de celdas en cada fila, y la fila separadora de la cabecera decide el número de columnas de toda la tabla. Si el conversor cuenta mal una fila, la tabla es inválida y se muestra como texto literal con barras.
Es un fallo visible, lo cual es una suerte: lo verás de inmediato en lugar de descubrirlo más tarde. Una tabla así está rota:
| Región | T1 | T2 |
| --- | --- | --- |
| Norte | 120 | 140 |
| Sur | 95 |
| Este | 88 | 102 |Cómo arreglarla
Añade la celda que falta, vacía si la celda de origen estaba vacía. Todas las filas deben tener el mismo número de barras que la fila separadora.
| Región | T1 | T2 |
| --- | --- | --- |
| Norte | 120 | 140 |
| Sur | 95 | |
| Este | 88 | 102 |El escapado, y por qué a veces salen barras invertidas
Markdown da significado a caracteres que aparecen en la prosa corriente. Un asterisco significa énfasis, un guion bajo significa énfasis, una almohadilla al principio de línea significa título, y un número seguido de un punto al principio significa elemento de lista.
Cuando esos caracteres aparecen en tu documento como ellos mismos — una marca de nota al pie, un nombre de variable con guiones bajos, una línea que de verdad empieza por "1985." — hay que escaparlos con una barra invertida o cambiarán en silencio cómo se muestra el documento. Una barra invertida en la salida suele ser el conversor siendo cuidadoso, no un error.
Si una barra invertida te estorba, borrarla es seguro siempre que compruebes después cómo queda la línea.
Adónde va el archivo después
Markdown es texto plano, que es la razón de convertir en primer lugar: se puede buscar con grep, se puede comparar con diff y lo podrá leer dentro de cincuenta años cualquier cosa capaz de abrir un archivo de texto.
Para un repositorio, ponlo en el árbol y deja que la revisión de código haga su trabajo. Para un almacén de notas, revisa antes la escalera de títulos, porque la mayoría construyen su esquema a partir de ella. Para un sitio estático, añade el front matter que necesite tu generador: ningún conversor puede inventarlo, porque no está en el PDF. Para alimentar un modelo de lenguaje, mira la guía sobre preparar PDF para recuperación, que es otro trabajo con otras prioridades.