Search...Search plugins and themes...
⌘K
Sign in
  • Get started
  • Download
  • Pricing
  • Enterprise
  • Account
  • Obsidian
  • Overview
  • Sync
  • Publish
  • Canvas
  • Mobile
  • Web Clipper
  • CLI
  • Learn
  • Help
  • Developers
  • Changelog
  • About
  • Roadmap
  • Blog
  • Resources
  • System status
  • License overview
  • Terms of service
  • Privacy policy
  • Security
  • Community
  • Plugins
  • Themes
  • Discord
  • Forum / 中文论坛
  • Merch store
  • Brand guidelines
Follow us
DiscordTwitterBlueskyThreadsMastodonYouTubeGitHub
© 2026 Obsidian

Jupyter Notebook Viewer

cteplovscteplovs141 downloads

Renders .ipynb Jupyter notebook files with syntax-highlighted code cells, formatted markdown, and inline outputs.

Add to Obsidian
  • Overview
  • Scorecard
  • Updates1

Renders .ipynb (Jupyter notebook) files natively inside Obsidian — markdown cells as prose, code cells with syntax highlighting and execution-count badges, and outputs (text, tables, errors) inline.

Features

  • Markdown cells rendered using Obsidian's own renderer — wikilinks, bold, italics, and all standard formatting work
  • Code cells with Python syntax highlighting and [N] execution-count badges
  • Stream output (stdout/stderr) displayed as monospace text
  • Rich output — pandas and polars DataFrame HTML tables rendered with scrollable, theme-aware styling
  • Error tracebacks with ANSI escape codes stripped for clean display
  • Theme-aware — all colors use Obsidian CSS variables; works in light mode, dark mode, and any community theme
  • No build step — plugin is plain JavaScript, no Node.js or npm required

Installation

From the Community Plugin Directory

Search for "Jupyter Notebook Viewer" in Settings → Community plugins → Browse.

Manual installation

  1. Download main.js, manifest.json, and styles.css from the latest release.
  2. Create a folder <your-vault>/.obsidian/plugins/jupyter-viewer/.
  3. Place the three downloaded files into that folder.
  4. Open Obsidian, go to Settings → Community plugins, disable Restricted Mode if prompted, then enable Jupyter Notebook Viewer.

Usage

Click any .ipynb file in the Obsidian file explorer. It opens in the notebook viewer automatically.

To switch back to raw JSON (e.g., for copying cell contents), right-click the file and choose Open with → Default editor.

Supported output types

Output type Rendered as
stream (stdout) Monospace preformatted text
stream (stderr) Monospace text in error color
execute_result / display_data with text/html Scrollable HTML table
execute_result / display_data with text/plain Monospace preformatted text
error Exception header + cleaned traceback
image/png Inline image (base64)

Compatibility

  • Obsidian 1.0.0+
  • Desktop only (uses Obsidian's desktop file APIs)
  • Jupyter notebook format v4 (nbformat 4)

License

MIT — see LICENSE.

95%
HealthExcellent
ReviewSatisfactory
About
Render .ipynb files natively inside Obsidian, presenting markdown cells with Obsidian's renderer and code cells with Python syntax highlighting and execution-count badges. Display outputs inline — stdout/stderr as monospace streams, cleaned error tracebacks, inline images, and scrollable, theme-aware HTML tables.
FormatsMarkdownCode
Details
Current version
1.0.0
Last updated
Last month
Created
Last month
Updates
1 release
Downloads
141
Compatible with
Obsidian 1.0.0+
Platforms
Desktop only
License
MIT
Report bugRequest featureReport plugin
Author
cteplovscteplovs
GitHubcteplovs
  1. Community
  2. Plugins
  3. Formats
  4. Jupyter Notebook Viewer

Related plugins

Importer

Import data from Notion, Evernote, Apple Notes, Microsoft OneNote, Google Keep, Bear, Roam, and HTML files.

Docxer

Import Word files easily. Adds a preview mode for .docx files and the ability to convert them to markdown (.md) files.

JS Engine

Run JavaScript from within your notes.

Templater

Create and use dynamic templates.

Outliner

Work with your lists like in Workflowy or Roam Research.

Mermaid Tools

Improved Mermaid.js experience: visual toolbar with common elements and more.

Various Complements

Complete words similar to auto-completion in an IDE.

Linter

Format and style your notes. Linter can be used to format YAML tags, aliases, arrays, and metadata; footnotes; headings; spacing; math blocks; regular Markdown contents like list, italics, and bold styles; and more with the use of custom rule options.

PlantUML

Generate PlantUML diagrams.

Fantasy Statblocks

Create, manage and view a Fantasy Bestiary with Dungeons and Dragons style statblocks.