zsviczian/obsidian-excalidraw-plugin
Obsidian Excalidraw Plugin
This is a drawing plugin for Obsidian that provides an integrated canvas editor for creating hand-drawn diagrams and sketches directly inside a note-taking vault. It functions as a freeform whiteboard-style editor where users can sketch, connect objects, and embed their drawings into markdown notes as SVG or PNG images.
The plugin extends beyond basic sketching by offering data-driven diagram generation, allowing users to create mindmaps, family trees, and charts by processing structured data from vault notes or scripts. It supports scriptable drawing automation through macros and automated sequences that can repeat common diagramming tasks, with macros assignable to command palette shortcuts. Users can insert editable LaTeX formulas into drawings for mathematical annotations, and link diagram elements to vault documents, external URLs, and block references with automatic link updates.
Additional capabilities include template-driven canvas initialization that loads pre-made drawing templates from vault files, automatic export of PNG or SVG copies on each save with per-file override options, and the ability to embed the full content of vault documents onto the canvas as styled snapshots. The plugin is installed and configured through Obsidian's community plugin system.
Features
- Visual Note-Taking - Creating and editing hand-drawn diagrams and sketches directly inside a note-taking vault for visual thinking and brainstorming.
- Interactive Drawing Tools - An integrated drawing tool that lets users create hand-drawn diagrams and sketches directly inside their Obsidian vault.
- Structured Data Diagram Generators - Generates visual diagrams by processing structured data from markdown notes or scripts into canvas elements like boxes and connectors.
- Data-Driven Diagram Generators - Create a visual diagram such as a mindmap, family tree, or chart by processing structured data from notes or scripts.
- Drawing Macros - Runs user-defined JavaScript macros that manipulate drawing elements through a command palette and tool group interface.
- Drawing Script Libraries - Execute macros from a script library, assign them to command palette shortcuts, and organize them into tool groups.
- Data-Driven Diagram Generators - Generating visual diagrams like mindmaps, family trees, or charts by processing structured data from notes or scripts.
- Embedded Document Renderers - Renders drawings as SVG or PNG images embedded directly inside markdown notes using a custom renderer that preserves interactivity and styling.
- Document Object Embedding - Insert a sketch into a markdown note as an embedded image with configurable size and alignment.
- Sketches in Notes - Inserting sketches as SVG or PNG images into markdown notes with configurable size and alignment for seamless document integration.
- Automated Drawing Sequences - Run a sequence of steps that add boxes, connect objects, or set styles to repeat common drawing tasks.
- Infinite Canvas Editors - A freeform whiteboard-style editor for sketching diagrams, connecting objects, and embedding them into markdown notes.
- Element-to-Document Links - Connecting drawing objects to vault documents, external URLs, and block references with automatic link updates.
- Freeform Sketching - Create and edit freeform sketches and diagrams directly inside a note-taking vault using an integrated drawing tool.
- Embedded SVG Styling - Insert a sketch as an SVG or PNG image directly into the current document.
- Canvas Templates - Loads pre-made drawing templates from vault files and applies their layout and styling to new or existing sketches.
- Media Reference Linking - Connect diagram elements to other vault documents, external URLs, and block references so links update automatically.
- Automatic Export Pipelines - Automatically exports drawings as PNG or SVG on save, with per-file override options controlled by configuration files.
- Drawing Automation Macros - Running macros and script sequences to automate repetitive drawing tasks such as adding boxes, connecting objects, or applying styles.
- Drawing Macros - Run macros and automated drawing sequences from a script library to repeat common diagramming tasks.
- Automatic Image Exports - Automatically save a PNG or SVG copy of a sketch each time it is saved, with per-file override options.
- Editable Formulas in Drawings - Adding mathematical formulas to drawings using a command palette action, with editable markdown or click-to-edit functionality.
- LaTeX Formula Editors - Add a mathematical formula to a drawing using a command palette action, editable in markdown or by clicking the formula.
- LaTeX Math Rendering - Insert editable LaTeX formulas into drawings using a command palette action for mathematical annotations.
- Dynamic Link Embedders - Connects drawing elements to vault documents, external URLs, and block references, automatically updating links when targets change.
