Cómo migré años de notas de Notion a Obsidian con Claude Code

Durante años fui "el del canal de Notion".

O sea, literalmente. La gente me conocía por eso. Y ahora, pues resulta que estoy en Obsidian y que llevaba tiempo con la espinita de migrar todo lo que tenía guardado en Notion sin perder nada por el camino.

El problema es que migrar de Notion a cualquier otro sitio es históricamente un dolor de cabeza. Exportas, crees que ya está, y cuando abres los archivos resulta que los enlaces apuntan a URLs de Notion que tú ya no quieres usar. Vamos, que te exporta las notas pero te deja atado al vendor igual. Un cachondeo.

¿Por qué migrar de Notion a Obsidian?

Antes de nada, la pregunta obvia.

No es una guerra Notion contra Obsidian. Notion me ha funcionado durante años y sigo pensando que es una herramienta brutal para ciertas cosas. Lo que pasa es que yo he cambiado. Mi cerebro TDAH pide cosas distintas ahora: archivos locales, markdown plano, grafo de conexiones, control absoluto sobre mis datos. Y Obsidian me da eso sin fricción.

Si ya te va bien con Notion, quédate. No tienes que migrar porque lo diga un tío en un blog.

Pero si llevas tiempo con la sensación de que Notion se te queda pequeño, o te da miedo depender de un servicio que algún día puede cambiar el pricing o desaparecer, o simplemente quieres tener todas tus notas en el mismo sistema que tu IA, entonces la migración es el primer paso.

Y ese primer paso es el que siempre paraliza.

El problema real de exportar desde Notion

Notion te deja exportar a markdown. Hasta ahí bien.

Lo que no te dice en ningún sitio es que cuando tiras de esa exportación los enlaces internos siguen apuntando a notion.so. O sea, tú tienes una nota que menciona a otra nota, y cuando abres el markdown resultante el enlace sigue llevando a una URL de Notion que, si mañana cancelas la cuenta, deja de funcionar.

Eso en una base de notas grande es una tragedia.

Porque un sistema de notas sin sus enlaces internos no es un sistema de notas. Es una pila de archivos sueltos. Que es justo lo que NO quieres.

Yo había intentado resolver esto antes. He probado exportadores de terceros. He escrito scripts a mano. He tocado cosas con regex que no quiero ni recordar. Y siempre quedaba algún rincón mal. Siempre algún enlace roto que tenías que arreglar a mano.

Y entonces, un día, pensé una cosa tan obvia que no sé cómo no se me había ocurrido antes.

Si ya uso Claude Code para todo, ¿por qué no para esto?

Llevo meses usando Claude Code como si fuera una extensión de mi cerebro. Lo uso para programar, sí, pero cada vez menos. Lo uso para ordenar carpetas, escribir emails, planificar contenido, gestionar mi funnel de ventas entero. Para todo.

Y de repente se me hizo la bombilla. Si esto al final es procesar archivos, ¿por qué no se lo tiro a Claude y que se apañe?

Lo bueno es que no hace falta hacer un prompt súper elaborado de antemano. Esa es la parte que la gente no entiende cuando ve este tipo de flujos en vídeos de YouTube. Piensan que estos sistemas salen a la primera, que te sientas con un plan superclaro y pum, todo funciona.

No.

La realidad es que yo me siento, exporto lo que tengo, se lo paso a Claude Code y le digo "oye, mira lo que hay aquí, haz que esto sea un sistema de markdown plano con enlaces relativos". Punto. Sin plan detallado. Sin preparación.

Y sobre lo que él devuelve, voy corrigiendo. Cuando algo sale mal, se lo digo. Cuando veo que ha tomado una decisión que no me cuadra, le digo que cambie. Y así, sobre la marcha, en quince o veinte minutos tienes el sistema entero migrado.

Si prefieres el formato vídeo, lo tienes aquí.

El truco que lo cambia todo: exportar en HTML

Aquí está la parte que casi nadie cuenta.

Cuando exportas desde Notion tienes dos opciones: markdown + CSV o HTML. La intuición te dice "si lo quiero en markdown, exporto en markdown". Pues es justo al revés.

La exportación HTML de Notion preserva los enlaces internos relativos. La de markdown no. Y como lo que vas a hacer es pasárselo a una IA para que lo reprocese, te interesa más la exportación que tiene la información intacta.

O sea, tú exportas en HTML. Notion tarda lo suyo (en mi caso tardó ridículo, os aviso). Y luego le dices a Claude Code: "aquí tienes una carpeta con HTML y CSVs de una exportación de Notion. Conviértelo a markdown plano estilo Obsidian con wikilinks. Si hace falta, lanza subagentes para procesarlo en paralelo."

Y se pone.

Va leyendo, va entendiendo la estructura, va montando un script de Python para procesarlo, y va convirtiendo. Por el camino se encuentra problemas que tú no habías previsto, y los va resolviendo solo. Que unos enlaces se quedan sin resolver. Que el Unicode de macOS hace cosas raras. Que al meter wikilinks dentro de tablas los separadores se comen los enlaces. Todo eso lo va detectando y arreglando sin que tú tengas que decir nada.

Lo único que tienes que hacer tú es abrir Obsidian, ver qué pinta ha quedado, y si algo no cuadra, decírselo. Ciclo corto de feedback.

Lo que más me flipó del proceso

Que cuando terminó, le pedí que me hiciera un tutorial de todo lo que había aprendido durante la migración. Todos los errores que había cometido. Todos los atajos que había descubierto. Todos los scripts que había creado.

Y me lo hizo.

Así que ahora yo tengo una guía paso a paso que funciona para cualquier persona que quiera migrar su Notion a Obsidian, independientemente de cómo tenga organizadas sus notas. Esa guía es exactamente la que puedes descargarte desde el recurso que te enlazo al final.

Esto es la parte que me sigue fascinando de trabajar con IA. Antes, hacer esto mismo me habría llevado días. Literalmente días de scripts, regex, peleas con codificaciones raras, documentar el proceso en un Google Doc, probar con varias carpetas distintas. Ahora se resuelve en una sesión de trabajo. Y encima sale documentado.

Es una de esas cosas donde la IA no te ahorra un 20% del tiempo, te ahorra un 95%. Y ese salto cualitativo cambia la forma en la que te planteas los proyectos.

¿Y si no sé usar Claude Code?

Mira, esto mismo que te estoy contando se puede hacer también con otras herramientas. Con Claude normal, la versión web o de escritorio, si le vas pasando los archivos. Con Gemini CLI, con Codex, con lo que tengas a mano.

Claude Code es el que uso yo porque para proyectos de este tipo, donde hay que procesar montones de archivos y montar scripts, es brutal. Pero no te obsesiones con la herramienta. Lo importante es entender el flujo: exportas, pides a la IA que procese, revisas, corriges, iteras.

Si nunca has usado Claude Code y te da pereza empezar, te dejo una guía para instalarlo sin saber programar. Es más fácil de lo que parece.

Y si esto te parece mucho, recuerda que el objetivo no es dominar una herramienta. El objetivo es no quedarte atado a un sistema de notas que ya no te sirve solo porque migrar suena a infierno. La IA ha convertido ese infierno en una tarde.

He documentado todo el proceso paso a paso, incluidos los errores que cometí y los scripts que acabaron funcionando, para que puedas migrar tu Notion sin pasar por mi aprendizaje a base de hostias.

Ver cómo migré de Notion a Obsidian