Tutorial: Cómo construir enlaces de Google Colab y nbviewer para notebooks de GitHub

1. Objetivo

Este tutorial explica cómo crear enlaces para abrir notebooks .ipynb almacenados en un repositorio de GitHub usando:

  1. Google Colab, para ejecutar el notebook.
  2. nbviewer, para visualizar el notebook cuando GitHub no lo muestra correctamente.
  3. El archivo README.md, para organizar los enlaces dentro del repositorio.

2. ¿Por qué necesitamos estos enlaces?

A veces GitHub no muestra correctamente la vista previa de los notebooks .ipynb y aparece un mensaje como:

An error occurred

o:

The notebook took too long to render

Esto no significa que el notebook esté dañado. El archivo sigue estando en el repositorio, pero GitHub no logró mostrarlo en vista previa.

Por eso se recomienda colocar en el README.md enlaces directos para abrir los notebooks en:

  • Google Colab
  • nbviewer

3. Estructura básica de un enlace de GitHub

Cuando un notebook está en GitHub, normalmente su enlace tiene esta forma:

https://github.com/USUARIO/REPOSITORIO/blob/main/NOMBRE_DEL_NOTEBOOK.ipynb

Por ejemplo:

https://github.com/justorfc/Estadistica_G1_3_SEMANAS_FINALES_2026_1/blob/main/1_SEMANA_1_Regresiones_Lineales.ipynb

Este enlace contiene cuatro partes importantes:

USUARIO:      justorfc
REPOSITORIO: Estadistica_G1_3_SEMANAS_FINALES_2026_1
RAMA:        main
ARCHIVO:     1_SEMANA_1_Regresiones_Lineales.ipynb

4. Cómo construir el enlace para Google Colab

4.1. Forma general

Para abrir un notebook de GitHub en Google Colab, use esta estructura:

https://colab.research.google.com/github/USUARIO/REPOSITORIO/blob/main/NOMBRE_DEL_NOTEBOOK.ipynb

Observe que se cambia esta parte:

https://github.com/

por esta:

https://colab.research.google.com/github/

El resto del enlace se conserva igual.

4.2. Ejemplo

Enlace original de GitHub:

https://github.com/justorfc/Estadistica_G1_3_SEMANAS_FINALES_2026_1/blob/main/1_SEMANA_1_Regresiones_Lineales.ipynb

Enlace para abrir en Google Colab:

https://colab.research.google.com/github/justorfc/Estadistica_G1_3_SEMANAS_FINALES_2026_1/blob/main/1_SEMANA_1_Regresiones_Lineales.ipynb

5. Cómo construir el enlace para nbviewer

5.1. Forma general

Para visualizar un notebook en nbviewer, use esta estructura:

https://nbviewer.org/github/USUARIO/REPOSITORIO/blob/main/NOMBRE_DEL_NOTEBOOK.ipynb

Observe que se cambia esta parte:

https://github.com/

por esta:

https://nbviewer.org/github/

El resto del enlace se conserva igual.

5.2. Ejemplo

Enlace original de GitHub:

https://github.com/justorfc/Estadistica_G1_3_SEMANAS_FINALES_2026_1/blob/main/1_SEMANA_1_Regresiones_Lineales.ipynb

Enlace para visualizar en nbviewer:

https://nbviewer.org/github/justorfc/Estadistica_G1_3_SEMANAS_FINALES_2026_1/blob/main/1_SEMANA_1_Regresiones_Lineales.ipynb

6. Regla práctica para convertir enlaces

Si tiene este enlace de GitHub:

https://github.com/USUARIO/REPOSITORIO/blob/main/ARCHIVO.ipynb

Entonces:

Para Google Colab

Reemplace:

https://github.com/

por:

https://colab.research.google.com/github/

Para nbviewer

Reemplace:

https://github.com/

por:

https://nbviewer.org/github/

7. Caso de notebooks dentro de carpetas

Si el notebook está dentro de una carpeta, también se conserva la ruta completa.

Enlace de GitHub

https://github.com/USUARIO/REPOSITORIO/blob/main/carpeta/notebook.ipynb

Enlace de Google Colab

https://colab.research.google.com/github/USUARIO/REPOSITORIO/blob/main/carpeta/notebook.ipynb

Enlace de nbviewer

https://nbviewer.org/github/USUARIO/REPOSITORIO/blob/main/carpeta/notebook.ipynb

8. Recomendación sobre los nombres de archivos

Para evitar problemas con los enlaces, se recomienda que los nombres de los notebooks no tengan:

  • Tildes.
  • Espacios.
  • Ñ.
  • Caracteres especiales.

Es mejor usar nombres como:

1_SEMANA_1_Regresiones_Lineales.ipynb

o:

2_SEMANA_1_Regresion_No_Lineal_y_Logistica.ipynb

En lugar de nombres como:

2 SEMANA 1 Regresión No Lineal y Logística.ipynb

9. Cómo escribir los enlaces en el README.md

El archivo README.md permite presentar información organizada dentro del repositorio.

Para crear un enlace en Markdown se usa esta estructura:

[Texto visible del enlace](URL)

Por ejemplo:

[Abrir en Colab](https://colab.research.google.com/github/justorfc/Estadistica_G1_3_SEMANAS_FINALES_2026_1/blob/main/1_SEMANA_1_Regresiones_Lineales.ipynb)

Esto se verá así en GitHub:

Abrir en Colab

10. Plantilla básica para el README.md

Puede copiar esta plantilla y adaptarla a su propio repositorio.

# Título del proyecto

Repositorio de apoyo para las actividades de la asignatura.

## Nota importante

Si GitHub muestra el mensaje **"An error occurred"** al abrir un notebook `.ipynb`, use los enlaces de Google Colab o nbviewer.

## Notebooks disponibles

| Sesión | Tema | Google Colab | nbviewer |
|---|---|---|---|
| Sesión 1 | Tema del primer notebook | [Abrir en Colab](ENLACE_COLAB_1) | [Ver en nbviewer](ENLACE_NBVIEWER_1) |
| Sesión 2 | Tema del segundo notebook | [Abrir en Colab](ENLACE_COLAB_2) | [Ver en nbviewer](ENLACE_NBVIEWER_2) |

11. Ejemplo completo de README.md

# Estadística Aplicada - Semana 1

Repositorio de apoyo para el desarrollo de las actividades de la asignatura **Estadística Aplicada con Python y R**.

## Nota importante

GitHub puede presentar fallas al mostrar la vista previa de archivos `.ipynb`.

Si aparece el mensaje:

**"An error occurred"**

esto no significa que el notebook esté dañado.

Para trabajar normalmente, use los enlaces de Google Colab.

## Notebooks disponibles

| Sesión | Tema | Google Colab | nbviewer |
|---|---|---|---|
| Sesión 1 | Regresiones lineales | [Abrir en Colab](https://colab.research.google.com/github/justorfc/Estadistica_G1_3_SEMANAS_FINALES_2026_1/blob/main/1_SEMANA_1_Regresiones_Lineales.ipynb) | [Ver en nbviewer](https://nbviewer.org/github/justorfc/Estadistica_G1_3_SEMANAS_FINALES_2026_1/blob/main/1_SEMANA_1_Regresiones_Lineales.ipynb) |
| Sesión 2 | Regresión no lineal y logística | [Abrir en Colab](https://colab.research.google.com/github/justorfc/Estadistica_G1_3_SEMANAS_FINALES_2026_1/blob/main/2_SEMANA_1_Regresion_No_Lineal_y_Logistica.ipynb) | [Ver en nbviewer](https://nbviewer.org/github/justorfc/Estadistica_G1_3_SEMANAS_FINALES_2026_1/blob/main/2_SEMANA_1_Regresion_No_Lineal_y_Logistica.ipynb) |

12. Cómo editar el README.md desde GitHub

Paso 1

Entre al repositorio en GitHub.

Paso 2

Haga clic en el archivo:

README.md

Paso 3

Haga clic en el ícono del lápiz:

Edit this file

Paso 4

Escriba o pegue el contenido del README.md.

Paso 5

Baje hasta la parte final de la página.

Paso 6

En el cuadro de confirmación escriba un mensaje como:

Actualiza README con enlaces a Colab y nbviewer

Paso 7

Haga clic en:

Commit changes

13. Cómo editar el README.md desde VSCode

Paso 1

Abra la carpeta del repositorio en VSCode.

Paso 2

Abra el archivo:

README.md

Paso 3

Escriba o pegue el contenido.

Paso 4

Guarde el archivo con:

Ctrl + S

Paso 5

Abra la terminal de VSCode:

Terminal → New Terminal

Paso 6

Ejecute los siguientes comandos:

git add README.md
git commit -m "Actualiza README con enlaces a Colab y nbviewer"
git push

14. Actividad sugerida para el estudiante

Cada estudiante debe realizar lo siguiente:

  1. Crear o abrir su repositorio en GitHub.
  2. Subir al menos un notebook .ipynb.
  3. Copiar el enlace del notebook en GitHub.
  4. Construir el enlace para Google Colab.
  5. Construir el enlace para nbviewer.
  6. Crear o editar el archivo README.md.
  7. Agregar una tabla con los enlaces.
  8. Verificar que los enlaces funcionen correctamente.

15. Tabla que debe entregar el estudiante en su README.md

## Notebooks del proyecto

| Nº | Nombre del notebook | Tema | Google Colab | nbviewer |
|---|---|---|---|---|
| 1 | nombre_notebook_1.ipynb | Tema 1 | [Abrir en Colab](ENLACE_COLAB) | [Ver en nbviewer](ENLACE_NBVIEWER) |
| 2 | nombre_notebook_2.ipynb | Tema 2 | [Abrir en Colab](ENLACE_COLAB) | [Ver en nbviewer](ENLACE_NBVIEWER) |

16. Verificación final

Antes de terminar, revise lo siguiente:

  • El repositorio está en GitHub.
  • El notebook aparece en la lista de archivos.
  • El enlace de Google Colab abre correctamente.
  • El enlace de nbviewer muestra correctamente el notebook.
  • El archivo README.md aparece en la página principal del repositorio.
  • La tabla del README.md está bien organizada.
  • Los enlaces no tienen errores de escritura.

17. Conclusión

El archivo README.md es la puerta de entrada del repositorio. Allí deben colocarse instrucciones claras, enlaces funcionales y una breve descripción del proyecto.

Cuando GitHub no pueda mostrar la vista previa de un notebook, los enlaces de Google Colab y nbviewer permitirán continuar trabajando sin depender del visor interno de GitHub.

Una recomendación práctica para sus estudiantes: primero deben copiar el enlace original del notebook desde GitHub y luego construir los otros dos enlaces reemplazando solo el inicio de la dirección. Esto evita errores de escritura.