IPYNB a PDF

Un archivo IPYNB es un cuaderno de Jupyter: un documento JSON que guarda una sesión de trabajo entera como una lista ordenada de celdas. Cada celda es de uno de tres tipos: celdas de markdown para el texto narrativo, los títulos, las tablas y las fórmulas LaTeX; celdas de código que contienen el código ejecutable más las salidas de la última ejecución; y celdas sin formato que pasan intactas, a menudo encabezados YAML para una cadena de publicación. Las celdas de código llevan además su número de ejecución, que es lo que Jupyter muestra como In [3] y Out[3]. Como .ipynb es JSON, GitHub puede representarlo pero casi nada más puede, y es un mal formato para compartirlo con alguien que solo necesita leer el análisis. Convertirlo a PDF lo resuelve. Este conversor lee automáticamente los tres tipos de celda, así que nunca tienes que pensar en cuál es cuál.

La vía de exportación integrada (File → Save and Export Notebook As → PDF, o jupyter nbconvert --to pdf) hace pasar tu cuaderno por LaTeX. Si no tienes instalado TeX Live, MiKTeX o Pandoc, te encuentras con el famoso «500: Internal Server Error» o con un mensaje nbconvert failed: xelatex not found, e instalar una distribución completa de TeX para exportar un solo documento son muchísimos gigabytes. Las versiones más recientes de nbconvert ofrecen --to webpdf, que representa el cuaderno a través de un navegador sin interfaz, pero eso significa otra instalación y la descarga de un navegador. Esta herramienta toma el mismo atajo sin ninguna preparación: analiza directamente el JSON del cuaderno y escribe el PDF ella misma, en tu navegador. Sin LaTeX, sin navegador sin interfaz, sin pip install y sin ninguna plantilla que elegir.

El PDF de un cuaderno solo resulta útil si conserva las partes que de verdad ejecutaste. Las celdas de markdown mantienen su jerarquía de títulos, el texto en negrita y cursiva, los enlaces, las listas anidadas, las citas, las líneas horizontales y las tablas GFM. Las celdas de código mantienen su sangría y reciben un resaltado de sintaxis según el lenguaje, ajustado al ancho de la página para que no se recorte nada. Las salidas se tratan según su tipo: los flujos de stdout se representan en monoespaciado sencillo, stderr recibe un tinte de advertencia, los resultados de ejecución se etiquetan como Out[n] y las trazas de error aparecen en un bloque rojo con el nombre de la excepción y el mensaje en la primera línea. Los gráficos y las imágenes (PNG, JPEG y SVG) se incrustan con su resolución original. Los DataFrame de pandas llegan como text/html y se reconstruyen como tablas PDF auténticas con bordes y fila de encabezado, en lugar de aplanarse en texto como hacen la mayoría de los conversores. El LaTeX de las celdas de markdown se compone correctamente, y los diagramas Mermaid también se dibujan.

nbconvert es la herramienta adecuada dentro de una cadena automatizada: es reproducible, admite plantillas y puede ejecutarse en integración continua. Es la herramienta equivocada cuando necesitas un PDF ahora, en una máquina donde LaTeX no está instalado, o cuando te topas con una incompatibilidad de plantilla después de actualizar Jupyter. Las quejas habituales (que jupyter pdf no genera salida, que las imágenes desaparecen de la exportación, que la plantilla classic ya no coincide con tu versión, que una exportación funciona en tu equipo pero no en el portátil de un compañero) vienen todas de la capa de LaTeX y no de tu cuaderno. Un conversor online no tiene ninguna capa de LaTeX que pueda fallar. La contrapartida es que no puede ejecutar tu cuaderno: en el PDF aparece lo que haya guardado en el archivo. Ejecuta todas las celdas y guarda antes de exportar, y los resultados coincidirán.

Google Colab no tiene exportación directa a PDF; el consejo habitual es imprimir la página del navegador, lo que pierde las salidas largas y añade los encabezados del navegador. En su lugar, elige File → Download → Download .ipynb y convierte ese archivo aquí: obtendrás una paginación correcta y texto localizable. Los cuadernos escritos con la extensión Jupyter de VS Code son archivos .ipynb corrientes y funcionan igual, igual que los descargados de un repositorio de GitHub (usa la vista Raw, o descarga el repositorio, para obtener el JSON en lugar de la página HTML que representa GitHub). Los cuadernos de Kaggle, Databricks, Deepnote y JupyterLite también se exportan como .ipynb. Los archivos antiguos de la época de IPython, que guardan las celdas bajo una clave worksheets, también se admiten; la mayoría de los conversores los rechazan sin más.

Reinicia el kernel y ejecuta todas las celdas antes de exportar, para que las salidas guardadas coincidan con el código y ninguna celda muestre un resultado viejo. Usa la orientación horizontal, o A3, cuando tu cuaderno tenga DataFrame o gráficos anchos; las tablas anchas se leen mucho mejor a lo ancho de la página. Estructura el cuaderno con títulos de markdown: se convierten en el índice de marcadores del PDF, que es lo que hace navegable un análisis largo. Desactiva los indicadores In[ ] / Out[ ] para un informe que deba leerse como un documento y no como un cuaderno, y desactiva las celdas de código por completo cuando solo quieras la narración y los gráficos. Mantén el tema de código claro para todo lo que pienses imprimir. Por último, si una celda produjo una vista interactiva de ipywidgets, Plotly o Bokeh, vuelve a ejecutarla con un representador estático: un widget vivo de JavaScript no tiene nada que dibujar en un PDF estático.