Pequeño script en Python para exportar notas en formato Markdown desde una carpeta de Obsidian hacia Notion, creando páginas en Notion con el contenido convertido.
- Lee archivos
.mden una carpeta local (y subcarpetas) que actúa como un "vault" de Obsidian. - Convierte formatos Markdown comunes (códigos, enlaces, negritas, itálicas, listas, encabezados, etc.) a bloques de Notion.
- Crea páginas y subpáginas en Notion manteniendo la estructura del directorio.
- Utiliza la API oficial de Notion con un token de integración para automatizar la importación.
- Python 3.6 o superior
- Librería
notion-clientinstalada (pip install notion-client) - Un token válido de integración en Notion y permiso para crear páginas en el workspace.
- Un vault local de Obsidian con archivos Markdown (
.md).
-
Clona este repositorio o descarga el script.
-
Crea un entorno virtual y actívalo (opcional pero recomendado):
python3 -m venv venv``source venv/bin/activate# En Windows usavenv\Scripts\activate -
Instala las dependencias: `pip install -r requirements.txt
Antes de ejecutar el script, debes configurar tres variables importantes en el código:
-
NOTION_TOKEN: El token de integración que obtienes al crear una integración en tu workspace de Notion. Este token permite al script acceder a tu cuenta y realizar cambios. -
ROOT_PAGE_ID: El identificador (ID) de la página raíz en Notion donde quieres que se creen las páginas con el contenido importado. Puedes obtener el ID copiándolo desde la URL de la página en Notion. -
VAULT_PATH: La ruta absoluta en tu sistema local donde está tu vault de Obsidian con los archivos Markdown que quieres subir. Cambia esta ruta para que apunte a la carpeta correcta en tu equipo.
Es fundamental que configures estas variables correctamente antes de ejecutar el script para que funcione sin errores.
Ejecuta el script desde tu terminal:
python script.py
El script recorrerá todo el vault especificado, creará páginas en Notion y subirá el contenido convertido en bloques compatibles.
- No subas tus tokens a repositorios públicos para evitar comprometer tu cuenta.
- Ajusta los permisos de integración en Notion según necesites.
- El script está pensado para vaults organizados y Markdown estándar.
Este proyecto está bajo la licencia MIT. ¡Siéntete libre de usarlo y adaptarlo!
Para dudas o contribuciones, abre un issue en GitHub o contacta al autor danielmhdev.
Este repositorio facilita la migración de notas desde Obsidian a Notion de forma automatizada y sencilla. Si te gusta el proyecto, considera darle una estrella ⭐️.