Overview of Jupyter Notebook Export Options

Jupyter Notebook files (.ipynb) are versatile and can be exported into various formats for different use cases. Below are some of the most common export formats:

• HTML: Exports the notebook as a static webpage, viewable in any browser with preserved formatting and outputs, though without interactive code execution.
• Markdown (.md): Converts the notebook into Markdown, which is ideal for platforms like GitHub or documentation tools that support Markdown rendering.
• PDF: Useful for generating printable or fixed-layout documents. Layout adjustments may be required during conversion to ensure proper formatting.
• Python Script (.py): Exports only the code cells into a Python script, suitable for reuse in other projects or version control systems.

Why Convert to Markdown and PDF?

Converting notebooks to Markdown and PDF is particularly useful when integrating with AI tools for summarization or annotation. For instance, models like Qwen (通义千问) support document uploads in formats like PDF and Markdown, enabling automated content processing and explanation. This guide focuses on these two formats due to their wide compatibility and ease of use.

Exporting to PDF

For PDF conversion, a free online tool such as IPYNB Converter can be used without writing any code. It supports multiple file conversions, including IPYNB to PDF, and offers additional features like converting PDF to Word or Excel.

Exporting to Markdown

To convert a Jupyter Notebook to Markdown programmatically, you can use the nbconvert library. First, install it using pip:

pip install nbconvert

Below is a Python script that performs the conversion:

from nbconvert import MarkdownExporter
from nbformat import read
import os

# Define the input notebook path
notebook_path = r"E:\data\test.ipynb"

# Set the output Markdown file path
markdown_path = os.path.splitext(notebook_path)[0] + ".md"

# Load the notebook content
with open(notebook_path, 'r', encoding='utf-8') as file:
    notebook_data = read(file, as_version=4)

# Initialize the Markdown exporter
markdown_exporter = MarkdownExporter()

# Convert notebook content to Markdown format
converted_content, _ = markdown_exporter.from_notebook_node(notebook_data)

# Save the Markdown output to a file
with open(markdown_path, 'w', encoding='utf-8') as output_file:
    output_file.write(converted_content)

print(f"Conversion complete. Markdown file saved to: {markdown_path}")