Cómo migrar de Notion a Obsidian con Claude Code paso a paso

Te dejo el vídeo arriba, pero aquí lo tienes escrito, con los pasos y los errores que fueron saliendo por el camino.

Mucha gente me pregunta cómo sacar sus cosas de Notion para llevárselas a otro lado sin que se rompa todo. Es una duda que entiendo perfectamente, porque migrar de Notion se convierte en un dolor de cabeza. Este vídeo lo grabé improvisando, sin saber si iba a salir bien o mal. Salió bien. Y de paso quedó un sistema que puedes replicar tú.

¿Por qué migrar de Notion es un dolor de cabeza?

El problema no es exportar. Notion te deja exportar tu espacio de trabajo cuando quieras. El problema son los enlaces.

Cuando exportas en Markdown, Notion convierte todos los enlaces internos en rutas que apuntan de vuelta a una página de Notion. O sea, exportas tu contenido, pero cada enlace te sigue mandando a Notion en lugar de a la página que ya te has llevado. No tiene ningún sentido. Es probablemente la mayor fricción de todo el proceso.

Si migras a un sistema de carpetas y archivos Markdown, como el que usa Obsidian, necesitas que esos enlaces sean rutas relativas dentro de tu propio sistema. Y eso, tal cual sale de Notion, no lo tienes.

¿Conviene exportar en Markdown o en HTML?

Aquí está el truco que cambia todo el proceso.

Mi primer instinto fue exportar en Markdown y CSV, que es lo lógico. Pero como lo que iba a hacer después era procesar los archivos con una IA, se me ocurrió probar algo distinto: exportar en HTML.

¿Por qué? Porque en Markdown los enlaces salen mal tirados. En cambio, al exportar en HTML, Notion sí genera enlaces internos correctos entre las páginas. Y eso es justo lo que necesitas para que la IA pueda reconstruir las rutas relativas sin inventarse nada.

Así que en la configuración de Notion me fui a "Exportar contenido del espacio de trabajo", elegí HTML, incluir bases de datos, incluir todo el contenido y crear carpetas para subpáginas. Un aviso: la exportación tardó una barbaridad. Notion te manda un correo cuando termina, pero no te avisa en la pantalla, así que no te quedes mirando fijamente como hice yo.

Cuando abrí el ZIP y comprobé uno de los archivos, ahí estaba lo importante: enlaces internos de verdad, no enlaces que te llevaban a Notion. Ese era el problemón resuelto de golpe.

Cómo hice la migración con Claude Code paso a paso

Con la exportación descargada, el resto fue hablarle a la IA. Yo usé Claude Code, aunque esto lo puedes hacer con otras herramientas del mismo estilo como Gemini CLI o Codex. Y como al final es procesar archivos sin más, también podrías hacerlo con Claude Cowork, aunque probablemente sea más lento.

Los pasos, tal cual los seguí:

1. Le dije que en la carpeta de descargas estaba toda la exportación de Notion, en HTML y CSV. 2. Le pedí que creara una carpeta nueva llamada "migración" y que dentro montara todo el sistema en Markdown, listo para usar en Obsidian. 3. Le sugerí que lanzara varios agentes para repartir el trabajo, porque era una tarea larga.

Y le di al enter. A partir de ahí, no quise saber nada. Que trabaje él.

Lo primero que hizo fue explorar la exportación para entender la estructura y el volumen: 447 archivos. Luego se montó su propio entorno virtual para instalar lo que necesitaba, escribió un script de Python adaptado a esa estructura concreta y lo ejecutó del tirón.

Lo que antes era una tarea costosísima de hacer a mano, se hizo prácticamente solo. Le costó más a Notion exportar que a Claude migrarlo entero.

¿Qué errores aparecieron por el camino?

Ninguna migración sale perfecta a la primera, y esta no fue la excepción. Lo interesante es que la IA encontró y arregló sus propios errores. Estos fueron los tres que salieron:

Enlaces a medias. Al principio, algunos enlaces se convirtieron en wikilinks de Obsidian y otros se quedaron como URLs crudas. El problema estaba en la resolución de rutas y en la normalización de Unicode de Mac. Lo detectó, lo depuró y lo arregló: acabó con 1302 wikilinks creados y cero enlaces sin resolver.

IDs colgando en los nombres. Los CSV eran básicamente índices de las tablas, y como cada carpeta ya generaba su propio índice en HTML, sobraban. Al pedirle que los quitara y limpiara los IDs de los nombres de archivo, aparecieron colisiones, porque había archivos nombrados solo con el ID. Le especifiqué que un ID solo tenía sentido cuando servía para nombrar algo como una imagen, y rehízo la parte que hacía falta.

Enlaces rotos dentro de tablas. Al quitar los IDs se comió el cierre de algunos wikilinks. La causa: dentro de una tabla, la barra vertical que usan los wikilinks la interpretaba como el salto a la siguiente celda. La solución fue escapar ese carácter. Después de eso, todo tiraba bien: abrí Obsidian, miré el grafo y ahí estaban todos los enlaces conectados desde el índice.

Lo bueno de trabajar así es que le puedes hablar en mitad del proceso, sin interrumpirlo, para corregir o añadir cosas sobre la marcha. No necesitas un plan perfecto de antemano. Yo iba pidiendo, veía el resultado y decidía el siguiente paso.

El paso final: pedirle un tutorial reutilizable

Cuando el sistema ya funcionaba, hice una última cosa que te recomiendo: le pedí que generara un archivo Markdown con un tutorial detallado de toda la migración, sin mencionar mi proyecto concreto, documentando los errores que había cometido y los scripts que había creado.

Así tienes un documento que sirve para dos cosas: seguirlo a mano, o pasárselo directamente a la IA con tu propia exportación para que haga el trabajo casi perfecto a la primera. Sobre esa base puedes pedirle mejoras a tu gusto, como convertir los autores en páginas propias con wikilinks o meter etiquetas por tipo. Eso ya no es universal, es cómo te guste tener tu sistema.

Esa misma guía, con los scripts y los pasos exactos, la dejé preparada como recurso: la tienes en la guía de migración de Notion a Obsidian.

Herramientas que aparecen en el vídeo

• Notion: de donde exportas. La clave es hacerlo en HTML, no en Markdown.
• Obsidian: el destino, un sistema de carpetas y archivos Markdown.
• Claude Code: la IA que procesó todo y escribió el script de migración.
• Gemini CLI y Codex: alternativas del mismo estilo para hacer lo mismo.
• Claude Cowork: otra opción si ya lo usas, aunque más lenta para esto.

Algunos enlaces son de afiliado: si compras, me llevo una comisión sin que a ti te cueste más.

Todo esto lo hice con Claude Code, que es la misma herramienta con la que me monto casi todo. Si quieres empezar de cero, en la guía de Claude Code para no programadores tienes por dónde arrancar, y si te preguntas por qué dejé Notion, lo cuento en por qué dejé Notion y qué uso ahora.

Si quieres aprender a usar Claude Code para montarte tus propias herramientas y sistemas, sin depender de ningún SaaS ni saber programar, ese es justo el terreno de mi curso de crear tu web con Claude Code.