Visor de Jupyter Notebook
Abre cualquier notebook .ipynb para leerlo tal como se veía en Jupyter: código resaltado, Markdown formateado con fórmulas, tablas de DataFrame, gráficos y trazas de error. No se ejecuta nada y no se sube nada; solo necesitas un navegador.
Última actualización:
Cómo usar Visor de Jupyter Notebook
- Abre el notebook: suelta el archivo .ipynb en el recuadro o haz clic para elegirlo. Hasta entonces se muestra un notebook de ejemplo.
- Navega con el índice generado a partir de los encabezados del notebook.
- Cambia la vista: desmarca Código para leer solo el texto y los resultados, o desmarca Salidas para ver solo el código.
- Copia el código de una celda con su botón Copiar, o el de todas las celdas de código a la vez con Copiar todo el código.
- Exporta el notebook renderizado como página HTML para compartirla o imprimirla, o como script .py.
Qué hay dentro de un archivo .ipynb
Un Jupyter notebook es un documento JSON. Su nivel superior contiene metadata (kernel e idioma), la versión del formato (nbformat) y una lista de cells. Cada celda tiene un cell_type y su texto source; las celdas de código también guardan un execution_count y las outputs producidas la última vez que se ejecutaron. Por eso un notebook se puede leer sin ejecutarlo: los resultados viajan dentro del archivo.
| Tipo de salida | Generada por | Cómo se muestra |
|---|---|---|
stream | print(), logging, barras de progreso (stdout o stderr) | Texto monoespaciado; stderr sobre fondo rojo claro; se conservan los colores ANSI |
execute_result | El valor de la última línea de una celda, como un DataFrame | El formato más completo disponible (tabla HTML, imagen, Markdown, texto) con Out [n] |
display_data | display(), figuras de matplotlib, objetos de IPython.display | Imágenes en PNG, JPEG o SVG; HTML depurado |
error | Una excepción que detuvo la celda | La traza completa en color |
Una sola salida puede contener varios formatos a la vez (un paquete MIME). Para un DataFrame de pandas, por ejemplo, el archivo guarda tanto text/html como text/plain; el visor elige el más completo que puede mostrar con seguridad, en este orden: HTML, SVG, PNG, JPEG, GIF, Markdown, LaTeX, JSON, texto sin formato.
Consejos
- ¿Las salidas aparecen vacías? Puede que el notebook se guardara después de Clear All Outputs, o que se subiera a Git sin las salidas (por ejemplo, con nbstripout). Vuelve a ejecutarlo en Jupyter para regenerarlas.
- Un tamaño de archivo enorme suele deberse a imágenes incrustadas: cada gráfico se guarda como texto base64, un 33% más grande que el propio PNG.
- Léelo como un informe desmarcando Código y Números In [ ]; lo que queda es el texto Markdown con tablas y gráficos.
- Obtén un script para el control de versiones con Descargar .py. Los marcadores
# %%conservan los límites de las celdas, así que herramientas como Jupytext pueden volver a convertir el script en notebook. - Los comandos de shell y los magics (
!pip install,%matplotlib inline) se comentan en la exportación .py para que el script siga funcionando en Python normal.
Preguntas frecuentes
¿Cómo abro un archivo .ipynb sin instalar Jupyter?
Suelta el archivo en esta página. Un notebook es un archivo JSON que ya contiene el código y las salidas guardadas, así que se puede mostrar sin Python ni kernel. Todo lo que ves, incluidos gráficos y tablas, procede de lo que se guardó la última vez que se ejecutó el notebook.
¿Puedo ejecutar las celdas de código aquí?
No. Esto es un visor, no un entorno de Python: muestra el código y las salidas guardadas en el archivo. Para ejecutar el notebook, ábrelo en Jupyter, JupyterLab, VS Code o Google Colab.
¿Por qué faltan algunas salidas o se muestran como texto?
Las salidas interactivas, como ipywidgets o gráficos de Plotly, Bokeh o Altair, necesitan JavaScript de un kernel activo, que aquí no se ejecuta por seguridad; el visor muestra la alternativa estática guardada con ellas, normalmente texto o una imagen. Además, si un notebook se guardó con las salidas borradas, no hay nada que mostrar aparte del código.
¿Se sube mi notebook a algún sitio?
No. El archivo se lee y se renderiza en tu navegador. Solo se descargan de una CDN pública las bibliotecas de código abierto para Markdown (marked), depuración de HTML (DOMPurify) y fórmulas (KaTeX); los datos de tu notebook se quedan en tu dispositivo.
¿Es seguro abrir un notebook de otra persona?
Sí. Los notebooks pueden contener salidas HTML y JavaScript. Jupyter solo las ejecuta en notebooks de confianza; este visor nunca ejecuta scripts y limpia todo el HTML con DOMPurify antes de mostrarlo.
¿Cómo convierto un notebook a HTML o a un script de Python?
Pulsa Descargar HTML para guardar una página independiente con el notebook renderizado, que también puedes imprimir en PDF. Descargar .py guarda las celdas de código como un script, con el Markdown como comentarios y marcadores # %% entre celdas, un formato que entienden VS Code, Spyder y Jupytext.
¿Qué versiones de notebook se admiten?
El formato de notebook 4 (el que usan desde 2015 Jupyter, JupyterLab, VS Code, Colab y Kaggle) y el antiguo formato 3 de IPython con worksheets. Las celdas de encabezado del formato 3 se muestran como encabezados Markdown.
¿Se prueban todas las herramientas de FreeToolCabin para comprobar su calidad y precisión?
Sí. Cada herramienta del sitio pasa pruebas automáticas en navegadores reales para comprobar que el resultado es correcto y que no hay errores. Si encuentras un fallo o tienes una sugerencia, escríbenos a [email protected] y lo revisaremos.