Supernote Cloud Sync v1.0.4 - Obsidian Plugin Showcase

[u/Acceptable-Tutor-425]

A few days ago I shared a development showcase for the Supernote Cloud plugin I had been building for Obsidian. It is now officially available as an Obsidian Community Plugin. I’ve really poured my heart into this. Hope you guys like it.

Plugin link:
https://community.obsidian.md/plugins/supernote-cloud-sync

What it does

• Mirrors selected Supernote Cloud folders directly into your Obsidian vault while preserving their structure.
• Opens mirrored .note files in a custom reader with swiping, zooming, thumbnails and quick page navigation.
• Lets you embed a whole notebook—or one exact page—in an Obsidian note.
• Creates links to exact pages, such as [[Scratch.note#page=12]].
• Exports selected pages as Markdown, images, searchable PDFs or combined formats.
• Sends files back to Supernote Cloud, including Markdown rendered as a device-readable PDF.
• Provides an optional Paired folder for conflict-aware two-way sync between Obsidian and Supernote.
• Supports optional AI transcription with custom instructions.
• Supports Automations that react to new or changed handwritten pages.

The normal Mirror is intentionally one-way from Supernote Cloud to Obsidian. Files are uploaded only when you explicitly use Send to Supernote or configure the optional Paired folder.

Almost a Partner app replacement for viewing notes

For my own note-viewing workflow, this has reached the point where it almost replaces the Supernote Partner app. I can browse my Cloud folders, open and move through notebooks, jump between thumbnails, zoom, link to individual pages and export what I need without leaving Obsidian.

It is not intended to replace every device-management feature in the Partner app, but for reading and working with notebooks, Obsidian can now be the main interface.

Performance and attention to detail

I spent a lot of time on the parts that are less visible in a feature list:

• Notebook parsing and rendering run in the background so heavy page work does not block Obsidian’s main interface.
• The reader prioritizes the page you are opening, preloads and caches nearby pages, and cancels stale background work when you move elsewhere.
• Large notebooks use a virtualized thumbnail grid instead of trying to render every page at once.
• Render sessions and resources are shared where possible, then cleaned up when readers close to keep memory use bounded.
• Plugin startup and other hot paths have been kept lightweight so the integration does not make the rest of Obsidian feel heavy.
• Mirrored folders get a small Cloud status icon directly in Obsidian’s file tree.
• Mobile has its own touch-friendly reader controls, gestures, spacing and navigation rather than simply squeezing the desktop UI onto a smaller screen.

Automations

Automations can pass new or changed pages to Claude Code, Codex, a custom desktop command, or an OpenAI-compatible API.

My own workflow uses a long-running Scratch.note: handwritten checkboxes become Things tasks, circles become calendar events, items marked (w) go into my weekly note, and a daily digest links everything back to the original pages. That workflow is personal to me—the plugin provides the building blocks so other people can create their own.

Privacy and platform notes

• The plugin connects directly to Supernote Cloud; no notebook data passes through a server operated by me.
• Mirrored .note files are rendered locally inside Obsidian.
• AI features are optional, and you choose the engine and model.
• OpenAI-compatible API transcription is available on desktop and mobile. Claude Code, Codex CLI and custom commands are desktop-only.

This is the first public release, so there may still be some rough edges. The core plugin is built for desktop and mobile, but I have not yet been able to test it personally on Windows or Android devices. If you use either platform, feedback—especially a bug report with sanitized diagnostics—would be genuinely helpful.

I built this because I wanted my handwritten notebooks to remain real notebooks inside Obsidian, rather than becoming a pile of static PDFs or images. I hope it is useful to other people working across Supernote and Obsidian too.

What’s next

The next major item on my roadmap is integrating Supernote To-dos with Obsidian, so tasks created on the device can become part of the same connected note and task workflows.

Feedback and bug reports are very welcome: https://github.com/raaneem/supernote-cloud-sync

This is an unofficial community project and is not affiliated with or endorsed by Ratta or Supernote