143/365 · Markdown | organizar ideas vs facilitar información

Los archivos Markdown (los famosos .md) son algo que llevo usando desde hace años, pero hasta que empecé a trabajar en serio con IA no entendí del todo su potencial. Porque resulta que los md son archivos compuestos por caracteres con un formato de análisis rápido y ágil para la inteligencia artificial (o al menos así lo he percibido). Y eso, cuando estás trabajando con documentos largos, complejos, o que necesitas transformar de un formato a otro, marca una diferencia brutal.

Para una IA, analizar un PDF es más laborioso que trabajar con un md como fuente RAG de alimentación. Y esto no es un detalle técnico sin importancia — es la diferencia entre que un proceso te lleve cinco minutos o media hora, entre que la IA te devuelva un resultado limpio o lleno de errores de interpretación. Porque un PDF puede tener tablas mal formateadas, textos en columnas que se leen mal, imágenes incrustadas que interfieren... Un Markdown es texto plano con estructura clara. Y para una máquina (y para muchos humanos también), eso es oro.

De PDF a Markdown: el paso previo

Cuando trabajo con documentos oficiales (por ejemplo, protocolos educativos de la consellería), el primer paso no es meterle el PDF directamente a la IA y pedirle que haga magia. El primer paso es transformar ese PDF en un Markdown limpio. Y aquí es donde mucha gente se atasca, porque ese proceso requiere supervisión.

Suelo usar documentos como, por ejemplo, protocolos educativos de la consellería para transformarlos en una de las conversaciones con la IA en un md completo al que no debe añadir, omitir, incorporar, aclarar, inventar... nada. Debe respetar el contenido y esto es fundamental. Porque si la IA interpreta, resume o "mejora" el contenido original, ya no estás trabajando con el documento oficial — estás trabajando con una versión alterada. Y eso, cuando se trata de normativa educativa, protocolos de centro, o cualquier cosa que tenga implicaciones legales, es un problema gordo.

Entonces, mi instrucción a la IA en ese primer paso es clarísima: "Convierte este PDF en Markdown respetando EXACTAMENTE el contenido original. No resumas, no parafrasees, no corrijas erratas, no añadas aclaraciones. Texto literal." Y luego, reviso. Porque aunque la IA sea buena, a veces se come un párrafo, a veces interpreta mal una tabla, a veces mete un salto de línea donde no lo hay. Y esos errores, si no los cazas, se propagan a todo lo que hagas después.

Markdown como fuente RAG

RAG (Retrieval-Augmented Generation) es básicamente un sistema donde la IA no solo genera texto desde su conocimiento previo, sino que también consulta documentos que tú le proporcionas como fuente de verdad. Y para que eso funcione bien, esos documentos tienen que estar en un formato que la IA pueda procesar de forma rápida y precisa. Y ahí es donde Markdown funciona increíble

Porque un Markdown tiene una estructura jerárquica clara: títulos con #, subtítulos con ##, listas con guiones o números, énfasis con asteriscos... La IA puede "leer" esa estructura y entender qué es un título, qué es un párrafo, qué es una lista. Con un PDF, tiene que inferirlo (y a veces falla). Con un Markdown, está explícito.

Entonces, cuando ya tengo el protocolo educativo (o lo que sea) en Markdown limpio, lo uso como fuente RAG en otra conversación. Y ahí sí, le pido a la IA que haga cosas: que lo transforme en HTML, que genere una versión simplificada para familias, que cree un esquema visual, que extraiga los puntos clave... Pero siempre desde esa base sólida que es el Markdown verificado. No desde el PDF original, que puede tener errores de interpretación.

De Markdown a HTML: el paso que cierra el círculo

Una vez tengo el Markdown verificado, en otra conversación utilizo las skills creadas (te explico luego qué son) y creo el HTML, por ejemplo de un protocolo educativo, que luego subo a edumind.es/recursos. Y aquí es donde el Markdown vuelve a demostrar su utilidad: es trivial convertir Markdown a HTML, porque la sintaxis es casi paralela. Un # en Markdown es un h1 en HTML. Un ## es un h2. Una lista con guiones es un ul/li. La transformación es directa, predecible, y con pocos errores.

Parece fácil, ¿verdad? Pero hay que añadir cositas: conocimiento propio previo. Saber si existen errores, asumir que los habrá, pero el 90% del trabajo duro está hecho. Porque si intentas hacer todo el proceso de golpe (PDF directamente a HTML), la tasa de error se dispara. Pero si lo haces en pasos (PDF → Markdown verificado → HTML), cada paso es simple, controlable, y puedes detectar problemas antes de que se enquisten.

Las skills: instrucciones reutilizables que te ahorran la vida

Mencioné las skills y creo que merece la pena explicar qué son (aunque lo desarrolle más en otro post). Básicamente, una skill es un conjunto de instrucciones que le das a la IA y que puedes reutilizar una y otra vez. Por ejemplo, tengo una skill que se llama "Markdown a HTML educativo" que le dice a la IA exactamente cómo quiero que haga la conversión: qué etiquetas usar, qué estructura mantener, qué clase CSS poner a ciertos elementos, cómo gestionar las listas, cómo formatear los enlaces...

Sin esa skill, cada vez que quisiera convertir un Markdown a HTML tendría que escribir todas esas instrucciones desde cero. Con la skill, simplemente la activo y la IA ya sabe qué hacer. Y eso, cuando trabajas con decenas de documentos, te ahorra horas. Y errores, porque las instrucciones son siempre las mismas — no hay riesgo de que un día se te olvide especificar algo y el resultado salga distinto.

Y esto es clave: el conocimiento propio previo del que hablaba antes se cristaliza en las skills. Tú sabes cómo quieres que se vea el HTML final, qué estructura tiene que tener, qué elementos son importantes... y lo destilaciones en una instrucción reutilizable. La IA ejecuta, tú supervises, y el resultado es consistente.

Markdown para organizar ideas (no solo para código)

Pero el Markdown no es solo una herramienta técnica para procesar documentos con IA. Es también (y quizá principalmente) una forma de organizar ideas. Porque escribir en Markdown te obliga a pensar en estructura: ¿esto es un título? ¿Esto es una subsección? ¿Esto es una lista? Y esa reflexión sobre la jerarquía de la información te ayuda a clarificar el pensamiento.

Yo uso Markdown para tomar notas en formaciones, para planificar proyectos de aula, para escribir borradores de documentos que luego transformaré en otro formato. Porque es rápido (no tienes que estar clicando en menús para poner negrita o crear listas), es portable (un archivo .md se abre en cualquier editor de texto), y es limpio (no hay formato invisible que te esté jugando malas pasadas, como pasa con Word).

Y cuando trabajas con alumnado más mayor (final de primaria, secundaria), enseñarles Markdown es regalarles una herramienta para toda la vida. Porque es la base de cómo se escribe documentación técnica, cómo se organizan wikis, cómo funcionan muchas plataformas de publicación... Y además, les enseña a pensar en términos de estructura, no solo de contenido. ¿Qué es más importante, un título o un párrafo? ¿Cómo organizo esta información para que se entienda? Esas preguntas no son solo técnicas — son cognitivas.

El 90% del trabajo duro (y el 10% que no puedes automatizar)

Volviendo al flujo de trabajo que comentaba: PDF → Markdown verificado → HTML final. El 90% del trabajo duro (copiar, formatear, estructurar) lo hace la IA. Pero hay un 10% que no puedes automatizar: la verificación. Comprobar que el Markdown respeta el original. Comprobar que el HTML se ve bien. Comprobar que no hay errores de interpretación, enlaces rotos, listas mal anidadas, títulos que deberían ser subtítulos...

Y ese 10% requiere conocimiento propio previo. Requiere saber cómo debería verse el resultado final, qué es aceptable y qué no, dónde suelen aparecer los errores típicos. Y eso no te lo da la IA — te lo da la experiencia. Por eso insisto tanto en que el que piense que puede hacer lo que hace con IA, debe tener claro que sin ella debe poder hacerlo. Porque si no sabes detectar cuándo la IA se ha equivocado, acabas publicando contenido con errores que ni siquiera ves (y yo en algún momento he caído en la trampa...).

Pero cuando juntas ambas cosas — la potencia de la IA para procesar y transformar, y tu criterio para verificar y ajustar — ahí es cuando el flujo de trabajo se vuelve realmente eficiente. Documentos que antes te llevaban horas ahora te llevan veinte minutos. Recursos que antes no podías ni plantearte crear (porque el esfuerzo técnico era desproporcionado) ahora son viables. Y eso, en educación, significa más tiempo para lo que de verdad importa: estar con tu alumnado.

Mañana te cuento qué son exactamente esas skills y cómo las uso. Porque esto del Markdown es solo una pieza del puzzle.

Nos vemos mañana.