Cómo usar Jupyter Notebook en QGIS para programar con PyQGIS

Si trabajas con QGIS y quieres aprender a programar con Python, ahora puedes utilizar Jupyter Notebook directamente dentro de QGIS gracias al plugin Notebook.

En este artículo veremos qué es QGIS Notebook, cómo instalar el plugin y cuáles son sus principales ventajas para aprender programación GIS y automatizar tareas geoespaciales.

¿Qué es QGIS Notebook?

Con el complemento Notebook, ahora podemos ejecutar Jupyter Notebooks directamente en QGIS, combinando la claridad del código Python interactivo con todas las funcionalidades de la API de QGIS. Esto crea un flujo de trabajo moderno y fluido para aprender PyQGIS, experimentar con código Python y crear análisis SIG reproducibles. A diferencia de la consola Python de QGIS, los cuadernos Jupyter permiten documentar procesos completos y ejecutar el código paso a paso.

Qiusheng Wu publicó la primera versión del complemento Notebook el 26 de diciembre de 2025.

Principales características del plugin Notebook para QGIS

• Abre y visualiza archivos de cuadernos Jupyter (.ipynb)
• Ejecuta celdas de cuaderno con el kernel de Python.
• Visualiza salidas de celdas de código y Markdown.
• Panel acoplable que se puede colocar en cualquier lugar de la interfaz de QGIS.
• Resaltado de sintaxis para celdas de código.
• Compatibilidad con salidas de Jupyter Notebook que incluyen texto, imágenes y HTML.
• Integración con el entorno Python de QGIS.
• Funcionalidad de guardado automático y exportación.

Usa este complemento para trabajar con cuadernos de Jupyter sin salir de QGIS.

Ventajas de utilizar Jupyter Notebook en QGIS

La integración de Jupyter Notebook en QGIS ofrece numerosas ventajas para usuarios de SIG y desarrolladores de PyQGIS:

• Aprender programación Python para GIS de forma visual.
• Documentar procesos de análisis geoespacial.
• Ejecutar código paso a paso.
• Combinar texto, imágenes y código en un único documento.
• Compartir análisis reproducibles con otros usuarios.
• Crear prototipos de herramientas y algoritmos antes de convertirlos en complementos de QGIS.
• Automatizar tareas repetitivas en QGIS mediante scripts Python.

Por estas razones, Jupyter Notebook se está convirtiendo en una de las mejores herramientas para aprender PyQGIS y automatizar flujos de trabajo GIS.

Cómo instalar Jupyter Notebook en QGIS

Iniciamos QGIS y desde el menú superior Complementos → Administrador de complementos, instalamos el complemento Notebook:

El desarrollo avanza rápidamente (versión 0.7 en el momento de escribir esto), por lo que habrá nuevas funciones cuando instale o actualice el complemento en comparación con el tutorial y el vídeo.

Interfaz y funcionamiento de QGIS Notebook

La interfaz de usuario es bastante sencilla, con solo unos pocos botones para agregar nuevo código o celdas Markdown y ejecutarlas.

Además, cuenta con un práctico menú desplegable con fragmentos de código predefinidos para que puedas empezar a trabajar. En la imagen anterior hemos seleccionado el código nº1. Environment Check. Para ejecutar el código basta con pinchar en el botón azul Run.

También podemos utilizar el fragmento nº6 Add XYZ Tiles (OpenStreetMap):

url = "type=xyz&url=https://tile.openstreetmap.org/{z}/{x}/{y}.png"
osm = QgsRasterLayer(url, "OpenStreetMap", "wms")

QgsProject.instance().addMapLayer(osm)

Al ejecutarlo se añadirá automáticamente la capa de OpenStreetMap al canvas de QGIS.

Para otras funciones, como eliminar celdas, hay que hacer clic con el botón derecho sobre la celda para acceder a la función a través del menú contextual. Y, por lo que sé, actualmente no hay forma de reorganizar las celdas (moverlas hacia arriba o hacia abajo).

Para más información, Qiusheng ha publicado un vídeo de introducción:

Compatibilidad de QGIS Notebook

El complemento Notebook está en constante desarrollo y es compatible con las versiones más recientes de QGIS. Dado que incorpora nuevas funciones con frecuencia, es recomendable mantener actualizado tanto QGIS como el complemento para aprovechar todas sus capacidades.

Conclusiones

El complemento Notebook supone un importante avance para los usuarios de QGIS interesados en aprender Python y PyQGIS. Gracias a la integración de Jupyter Notebook dentro de QGIS, es posible desarrollar, documentar y compartir análisis geoespaciales de una forma mucho más cómoda y profesional.

Si estás empezando con la programación GIS o quieres automatizar tareas en QGIS, esta herramienta puede convertirse en una pieza fundamental de tu flujo de trabajo.