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
  • Join the community
  • Discord
  • Forum / 中文论坛
  • Merch store
  • Brand guidelines
Follow us
DiscordTwitterBlueskyThreadsMastodonYouTubeGitHub
© 2026 Obsidian

Unofficial Supernote by Ratta Integration

philipsphilips15k downloads

View Supernote notes, generate markdown from note and capture screen mirror.

Add to Obsidian
  • Overview
  • Scorecard
  • Updates29

I use my Supernote for capturing hand written notes and reading documents.

But, I already use Obsidian for organizing and capturing all of my digital notes.

This plugin enables me (and now you!) to import handwritten notes into Obsidian and view them on a desktop, phone or tablet.

This plugin has four main features:

  • 📝 View Supernote *.note files in your Obsidian Vault. You can link to these notes from your Markdown notes too [My Note](example.note).

  • ➡️ Export Supernote *.note files as PNGs and/or markdown files and attach them to your Vault.

  • 📺 Copy an image from a Supernote via screen mirroring into your current note with the "Insert Supernote mirror image" command (demo video)

  • ⬇️ Download & Upload files directly from your device via the Supernote Browse & Access feature. (demo video)

Video Demo

Watch the video

Install via Community Plugin Store

This plugin is available via the Obsidian Community Plugin Store. Click the previous link or search for "Unofficial Supernote by Ratta Integration".

Install via BRAT

To test Beta builds of this plugin follow these steps:

  • Install the BRAT plugin via Community Plugin Search
  • Read the docs
  • Add https://github.com/philips/supernote-obsidian-plugin

Manually installing the plugin

  • Copy over main.js, manifest.json to your vault VaultFolder/.obsidian/plugins/obsidian-plugin-supernote/ from https://github.com/philips/supernote-obsidian-plugin/releases

Known Issues

There are a handful of known issues. Please check the issue list. If you don't see a matching issue please create a new issue?

Roadmap / Ideas

  • 🔗 Note linking
  • 🎛️ Settings panel to control file layout, linking, and more

Thank You

Thank you to Tiemen Schuijbroek for developing the initial supernote Typescript library I forked.

FAQ

Q Why isn't there a table of contents in the generated Markdown file?

A Because the Obsidian Outline sidebar accomplishes this same feature.

Other Helpful Plugins

These are not endorsements but might be useful to pair with this plugin.

  • Mousewheel Image Zoom
  • Image Toolkit

Relevant Resources

  • Obsidian and Supernote by Organizing for Change
  • E-Ink notes in Obsidian / Notion? by Brandon Boswell
  • Academic HANDWRITTEN notes in OBSIDIAN ft. Supernote by pixel leaves

Funding

I personally don't accept funding or donations for this project. However, if you feel inclined, consider donating to the Signal Foundation.

Developer Notes

  • Make sure your NodeJS is at least v16 (node --version).
  • Clone this repo.
  • Setup the deps
git submodule init
git submodule update
cd supernote-typescript/
npm run build
npm link
cd ..
npm link supernote-typescript/
  • npm i or yarn to install dependencies.
  • npm run dev to start compilation in watch mode.

Android Debugging

  • Ensure npm run dev is running above
  • Create a vault called "SupernoteTest"
  • Install the supernote plugin from the community store
  • Run npm run push-android to push main.js to the device
  • Run "Reload App without Saving" on Obsidian command palette
76%
HealthGood
ReviewCaution
About
View Supernote .note files directly in your vault and link to them from Markdown notes. Export .note files as PNGs or Markdown and attach them to your vault, insert screen-mirrored Supernote images into notes, and download or upload files via Supernote Browse & Access.
ImportAttachmentsImages
Details
Current version
2.9.1
Last updated
6 months ago
Created
2 years ago
Updates
29 releases
Downloads
15k
Compatible with
Obsidian 1.5.12+
License
MIT
Report bugRequest featureReport plugin
Sponsor
Support
Author
philipsphilips
ifup.org
GitHubphilips
  1. Community
  2. Plugins
  3. Import
  4. Unofficial Supernote by Ratta Integration

Related plugins

Local images plus

A reincarnation of Local Images to download images in Markdown notes to local storage.

Paste image rename

Rename image after pasting, support name pattern and auto renaming.

Image auto upload

Upload images from your clipboard by PicGo.

Image Context Menus

Image context menus (mostly on right click): Copy to clipboard, Open in default app, Show in system explorer, Reveal file in navigation, Open in new tab.

Epub Importer

Import EPUB files as Markdown.

Imgur

Upload images from your clipboard to imgur.com and embeds uploaded image to your note.

Media DB

Query multiple APIs for movies, series, anime, games, music releases and wiki articles, and import them into your vault.

Pixel Perfect Image

Pixel perfect 100% image resizing, copy to clipboard, show image in Finder/Explorer, edit image in external editor, and much more.

Google Photos

Google Photos integration.

Thumbnails

Insert YouTube thumbnails into your notes.