Just Simple Excalidraw

by David Hurt
5
4
3
2
1
Score: 48/100

Description

Category: Creative & Writing Tools

The Just Simple Excalidraw plugin provides a focused Excalidraw editor that reads and writes portable .excalidraw JSON files directly in the vault. It creates drawings from the command palette or ribbon, uses the official editor and saves changes automatically after a short pause. Pasted or selected images are embedded into each drawing so the file remains self contained. Autosave stops when the file changes outside the open editor, while malformed drawings are reported without altering the original. The plugin follows the active light or dark theme and makes no runtime network requests. It keeps one editor open per drawing to prevent competing saves, focuses an existing tab when the same file is reopened and closes temporary duplicate panes created by Obsidian's split commands.

Reviews

No reviews yet.

Stats

12
stars
2,894
downloads
3
forks
93
days
5
days
5
days
37
total PRs
0
open PRs
11
closed PRs
26
merged PRs
5
total issues
1
open issues
4
closed issues
31
commits

Latest Version

6 days ago

Changelog

Drawing previews

Embed a raw drawing with ![[drawing.excalidraw]] in Reading view or Live Preview. Add a width such as |380 if needed, and click or tap the preview to open the editor. Previews update when the drawing is saved.

Thanks to @andyherle for proposing the feature and sharing the working prototype in #40.

What's Changed

Full Changelog: https://github.com/DavidHurtadoAI/just-simple-excalidraw/compare/0.1.11...0.1.12

README file from

Github

Fixed in v0.1.7: earlier versions could overwrite a drawing when switching files in the same tab. Update to this version, and back up your .excalidraw files before upgrading as a precaution.

Changed in v0.1.8: reopening an already open drawing focuses its existing tab instead of creating a second editor. Obsidian's Split right and Split down commands are native pane actions; when used on a drawing, the temporary duplicate pane closes again to keep a single editor for the file.

New in v0.1.9: Just Simple Excalidraw is available on Obsidian mobile, with the same local-first drawing files and autosave behavior as desktop.

Just Simple Excalidraw

Fixed in v0.1.10: removed an unused upstream Firebase configuration and Google API key from the bundled editor to avoid secret-scanner alerts.

An intentionally small, local-first Excalidraw editor for Obsidian that preserves the original's brilliant simplicity. It edits portable .excalidraw JSON files directly in the vault.

Just Simple Excalidraw running in Obsidian

Why this plugin exists

Excalidraw is brilliant because it makes drawing feel immediate. Open a canvas, think with your hands, and get out of the way. Just Simple Excalidraw brings that essential experience to an offline Obsidian vault without turning it into another complex workspace.

The excellent Obsidian Excalidraw plugin by zsviczian offers extensive integrations and a large feature set for people who need them. This plugin has a deliberately different goal: no feature race, no extra workflow layer, and no attempt to reproduce hundreds of options. It is for people who want the original, focused Excalidraw canvas inside Obsidian.

If Excalidraw is an important part of your work, please consider supporting the upstream team with Excalidraw+. This plugin uses the open-source editor locally; Excalidraw+ helps sustain the product and adds online services for users who need them. If you need the advanced features this plugin intentionally leaves out, Excalidraw+ is the better fit—and directly supports the people building Excalidraw.

What it does

  • Creates and opens native .excalidraw drawings from the command palette or the ribbon.
  • Runs on Obsidian desktop, phones, and tablets.
  • Uses the official Excalidraw editor with its standard drawing tools.
  • Saves automatically after a short pause and writes images into the drawing as embedded data, so a drawing stays self-contained.
  • Stops autosave if its file changes outside the open editor, avoiding silent overwrites.
  • Reports malformed drawings without changing the original file.
  • Follows Obsidian's light and dark theme.

It deliberately does not add OCR, AI, collaboration, cloud sync, a drawing library, an account, or an export workflow. Those are valuable features in other tools; they are outside this plugin's purpose. The lean build also excludes Mermaid-to-Excalidraw conversion, web embeds, and the related heavy dependency tree.

Lean build and Obsidian Sync

Community Plugins installs main.js, manifest.json, and styles.css from a GitHub release. Since Obsidian Sync Standard cannot sync a plugin file larger than 5 MB, this plugin keeps its release main.js below that limit.

That constraint is intentional: Just Simple Excalidraw ships a focused editor, not every optional Excalidraw subsystem. It includes one embedded Excalifont subset covering Latin characters, including Spanish accents. Other scripts and the optional Excalidraw font variants fall back to fonts available on the local system. No font or code is downloaded at runtime.

What this trade-off means

To remain small, local, and Sync-friendly, the plugin does not include Mermaid-to-Excalidraw conversion, online collaboration, cloud services, an account, a library, advanced integrations, or the full set of optional fonts. It is intended for focused, offline drawing inside a vault. If those advanced capabilities matter to your workflow, use Excalidraw+: it provides the online service layer and helps fund ongoing Excalidraw development.

Privacy and permissions

Just Simple Excalidraw is local-first by design.

  • Network: it makes no runtime network requests. Its one bundled Latin font subset and all editor code are included in the release.
  • Vault files: it reads the .excalidraw files you open or embed and writes drawings you create or edit. Drawing previews are generated in memory.
  • Clipboard: standard copy and paste actions, including pasting an image, run only after you invoke them. The plugin does not read the clipboard in the background.
  • Files outside the vault: only an image explicitly chosen or pasted by you can be read; it is embedded into the active drawing. Images over 10 MiB are rejected.
  • Browser storage: the plugin itself does not persist vault data in localStorage or sessionStorage; the drawing file in your vault is the source of truth. The bundled upstream Excalidraw runtime contains browser storage support for its own optional editor state.
  • Telemetry, ads, accounts and payments: none.

Installation

Community Plugins

Once accepted into the Obsidian Community directory, install it from Settings → Community plugins and enable it.

Manual installation

Download main.js, manifest.json, and styles.css from the matching GitHub release. Put those three files in:

<vault>/.obsidian/plugins/just-simple-excalidraw/

Then enable Just Simple Excalidraw in Obsidian.

Use

Run Create new Excalidraw drawing from the command palette, or use the pencil ruler icon in the ribbon. The new file is created in the vault root using a timestamped Drawing YYYY-MM-DD HH.MM.SS.excalidraw name.

Edit an exported SVG or PNG

Export a drawing from Excalidraw with "Embed scene" enabled and keep its .excalidraw.svg or .excalidraw.png suffix. In Obsidian's file explorer, open the file's context menu and choose Open in Just Simple Excalidraw. Click Save image to update the same file with the edited drawing and its embedded scene. Standard clicks and note embeds display the file as an image. PNG exports are limited to 4096 pixels on the longest side. Publishing a saved file also publishes its editable scene.

Preview drawings in notes

Embed a drawing with ![[drawing.excalidraw]] in Reading view or Live Preview. Use ![[drawing.excalidraw|400]] to set its width in pixels. Click or tap the preview to open the drawing in the editor. It updates when the drawing is saved and follows Obsidian's light or dark theme.

One drawing, one editor

Each .excalidraw file is editable in one Obsidian tab at a time. Opening a drawing that is already open activates its existing tab. This prevents two editors from saving competing versions of the same file.

Obsidian's pane menu also shows Split right and Split down for every tab. Those commands belong to Obsidian, not to this plugin, so they cannot be hidden only for drawings through the supported plugin API. If you use either command on a drawing, Obsidian may briefly create a new pane; the plugin then returns focus to the original drawing and closes the duplicate pane.

Development

Requires Node.js 22.13 or later and npm.

Development note Just Simple Excalidraw was unapologetically vibe-coded: built iteratively with AI assistance, then tested and refined inside a real Obsidian vault.

npm ci
npm run check

npm run check type-checks the plugin, makes a production bundle without Mermaid, embeds the Latin font subset, installs the built plugin into the local development vault, and verifies both offline operation and the 5 MB Sync Standard file limit.

For an editable development build:

npm run dev

Release

Create a Git tag that exactly matches manifest.json's version (for example, 0.1.0). The release workflow builds and attaches exactly main.js, manifest.json, and styles.css to the GitHub release.

License and acknowledgements

This project is licensed under the MIT License. It bundles Excalidraw, React, and their production dependencies under their respective licenses; see THIRD_PARTY_NOTICES.md.

Excalidraw is an independent open-source project. This plugin is not affiliated with or endorsed by Excalidraw.

Optional custom font

Place a WOFF2, WOFF, TTF or OTF file (up to 2 MB) inside the vault. In Settings → Just Simple Excalidraw → Custom handwriting font, enter its vault-relative path, such as Fonts/My font.woff2, then restart Obsidian. It replaces the Excalifont handwriting face in existing and new text using that face. Clear the setting and restart to restore the bundled font. Missing, invalid or oversized fonts fall back to Excalifont with a notice.

The font is loaded locally; no system paths or remote URLs are accepted. It is not embedded in each drawing: other devices need the font file and the same setting. Drawings remain standard Excalidraw JSON. Changing fonts can change text metrics, so keep settings consistent across devices. The release still bundles a single Latin fallback and remains below 5 MB.

Similar Plugins

info
• Similar plugins are suggested based on the common tags between the plugins.
Excalidraw CN
3 years ago by Korbin Zhao
支持中文手写的 Excalidraw Obsidian 插件。A Obsidian plugin of Excalidraw supporting Chinese handwrite font.
Tldraw
3 years ago by Sam Alhaqab
A plugin to integrate tldraw into Obsidian.
Local GPT
3 years ago by Pavel Frankov
Local Ollama and OpenAI-like GPT's assistance for maximum privacy and offline access
Ink
3 years ago by Dale de Silva
Quran Helper
2 years ago by Ammar Alakkad
Obsidian plugin to find and insert any Quran Ayah (verse) in your notes
simple-sketch
2 years ago by Yoh
an Obsidian plugin to create minimal sketches
Excalidraw
6 years ago by Zsolt Viczian
A plugin to edit and view Excalidraw drawings in Obsidian
MoreDraw
2 years ago by webceoboy2011
mordraw.com for obsidian plugin
Auto Math
8 months ago by Vladislav Sorokin
Auto-expand LaTeX math snippets in Obsidian — write equations faster.
YAOS
6 months ago by kavinsood
A zero-terminal, real-time sync engine powered by your own Cloudflare Worker.
Math+
6 months ago by ocapraro
This is an Obsidian plugin for taking math notes using Excalidraw.
Excalidraw Extras
5 months ago by zsviczian
Companion Obsidian.md plugin hosting extra add-on optional features for the main Excalidraw-Obsidian plugin
Journalit
4 months ago by Cursive
Obsidian trading journal with broker sync, trade imports, analytics, prop firm tracking, reviews and rule-based trading workflows.
Offline Whisper Transcription
4 months ago by David Manthey
Bible Reference
4 months ago by tim-hub
Take Bible Study notes easily in the popular note-taking app Obsidian, with automatic verse and reference suggestions.
Mobile PDF Exporter
3 months ago by Murat
One-click selectable preview PDF export plugin for Obsidian mobile and desktop.
Tabula Rasa
3 months ago by Jeremiah Beatham
Excalidraw Math Plotter
3 months ago by ahmeddawoud3
Plot mathematical function graphs directly onto Excalidraw canvases.
HandLayers
3 months ago by [email protected]
Excalink
3 months ago by Aditya Kumar
Excalink is an Obsidian plugin that enables IntelliSense-style autocompletion for groups and named frames inside .excalidraw.md files. When you type [[filename#, it suggests all available frame names, allowing fast, precise linking to parts of your drawings.
Advanced Rename and Delete Handler
3 months ago by Michael Naumov
Handles renames and deletes for the whole vault in one place: updates links, moves attachment files and folders, and cleans up what a deletion leaves behind.
Office Suite
3 months ago by Vishal Rashmika
View and edit Microsoft Word (.docx), Excel (.xlsx), PowerPoint (.pptx), CSV/TSV spreadsheets, and PDF documents directly inside Obsidian with native WYSIWYG editing, formatting, and formulas.
Vault Shelf
2 months ago by Lukas Proprentner
Your Obsidian vault as a browsable library: shelves of books built from titles, dates, people, tags, folders or any note property. Customizable to make it your own.
OsyC
2 months ago by 3yesore
Mapa neuronal
2 months ago by Felipe Córdova
A graph that explains itself: your Obsidian vault as a layered neural map, with the reason each note links to the next.
Mappy
2 months ago by hiroyaiizuka
An Obsidian plugin to view and edit Markdown notes as linked, illustrated mind maps.
Ontomark
a month ago by DreamLab AI
Offline ontology reasoning, SPARQL and reviewed frontmatter edits for Obsidian
QMD Search
a month ago by xia-ataraxia
Obsidian plugin for local QMD search, related notes, and autosync.