ipynbconverter

CLI tool to convert between Jupyter Notebook (.ipynb) and JSON formats bidirectionally.

Installation

npm install -g ipynbconverter

Or use it directly with npx:

npx ipynbconverter <input-file> [output-path] [--minify]

Usage

ipynbconverter <input-file> [output-path] [--minify]

Examples

# Convert notebook to JSON in same directory
ipynbconverter notebook.ipynb

# Convert JSON to notebook with specified output
ipynbconverter data.json ./output/notebook.ipynb

# Batch convert multiple files
ipynbconverter *.ipynb ./converted/

# Output minified JSON
ipynbconverter notebook.ipynb --minify

Options

• --minify / -m: Output compact JSON instead of pretty-printed
• --help / -h: Show help message
• --version / -v: Show version information

Features

• Auto-detection: Automatically determines conversion direction based on file extension
• Batch processing: Supports glob patterns for converting multiple files at once
• Validation: Validates input files and provides helpful error messages
• Smart output: Auto-generates output filenames if not specified
• Cross-platform: Works on Windows, macOS, and Linux

Supported Platforms

This package includes pre-built binaries for:

• Windows (x64)
• macOS (x64/arm64)
• Linux (x64)

License

MIT

Repository

https://github.com/dakshjainn/ipynb_converter

Issues

Please report issues at: https://github.com/dakshjainn/ipynb_converter/issues