Jupyter Notebook Viewer

View Jupyter notebooks (.ipynb) directly in Obsidian with rendered code, markdown, and outputs.

Features

• Native .ipynb support - Click any Jupyter notebook file to view it rendered in Obsidian
• Code cells - Displays code with syntax highlighting and execution counts
• Markdown cells - Renders markdown content using Obsidian's built-in renderer
• Output rendering - Supports multiple output types:
  • Text output (stdout/stderr streams)
  • Images (PNG, JPEG)
  • HTML output
  • Error tracebacks
• Collapsible cells - Click the cell header to collapse/expand individual cells
• Theme-aware - Respects your Obsidian theme colors

Installation

From Obsidian Community Plugins (Recommended)

1. Open Settings → Community plugins
2. Disable Safe mode if prompted
3. Click Browse community plugins
4. Search for "Jupyter Notebook Viewer"
5. Click Install, then Enable

Manual Installation

1. Download main.js, manifest.json, and styles.css from the latest release
2. Create a folder named jupyter-viewer in your vault's .obsidian/plugins/ directory
3. Copy the downloaded files into that folder
4. Enable the plugin in Settings → Community plugins

Usage

Simply click on any .ipynb file in your vault to open it with the Jupyter viewer. The notebook will be rendered with:

• Code cells showing source code and outputs
• Markdown cells rendered with Obsidian's markdown processor
• Collapsible cells for easier navigation

Commands

• Open Jupyter Notebook - Opens the active .ipynb file in the viewer

Supported Output Types

Output Type	Support
Text (stdout/stderr)	✅ Full support
Images (PNG/JPEG)	✅ Full support
HTML	✅ Full support
Plain text	✅ Full support
Errors	✅ Full support with traceback
Plotly	⚠️ Placeholder shown

Contributing

Contributions are welcome! Please feel free to submit issues or pull requests on GitHub.

License

MIT License