SiYuan js-draw Plugin

This plugin allows you to embed js-draw whiteboards anywhere in your SiYuan documents.

▶️ LiuYun thread

Usage instructions

Install the plugin from the marketplace by searching for js-draw.

Creating a whiteboard

There are two ways to create a new whiteboard:

• Slash command — type /Insert whiteboard in your document and select the menu entry.
• Keyboard shortcut / toolbar icon — press Alt+Shift+D or click the toolbar icon without selecting anything. A new whiteboard will be inserted at your cursor position.

The editor will open in a new tab (or dialog on mobile). Draw what you like, then click Save and close the editor.

Editing a whiteboard

Select an existing whiteboard by left-clicking it, then open the editor in one of these ways:

• Press Alt+Shift+D or click the toolbar icon.
• Right-click the whiteboard (or tap the three dots on mobile) and choose Plugin → Edit whiteboard.

Unsaved changes

If you close the editor without saving, your changes are automatically preserved and you'll be given the option to keep or roll back to the previous version.

Unsaved drawings are also automatically saved when the app exits. Note: this emergency save happens after SiYuan's final sync, so it may cause sync conflicts if you use SiYuan across multiple devices. Make a habit of saving manually before closing.

Planned features

Check out the Projects tab!

Contributing

Contributions are always welcome!
The Chinese translation is made by Kimi AI, and I'm unable to verify it because I don't speak Chinese. If you do and find issues, please let me know.
Please open an issue or contact me if you'd like to help!

Thanks to

This project couldn't have been possible without (in no particular order):

• The SiYuan project
• js-draw
• SiYuan plugin sample with vite and svelte
• siyuan-drawio-plugin and siyuan-plugin-whiteboard for inspiration and bits of code

Make sure you check them out and support them as well!

License

The original plugin framework is developed by SiYuan 思源笔记 and licensed under the MIT license.
All changes made by me are copyright MassiveBox 2025, and licensed under the MIT license.