If you are enjoying the Excalidraw plugin then please support my work and enthusiasm by buying me a coffee on https://ko-fi/zsolt.
Jump ahead to the #List of available scripts
Introducing Excalidraw Automate Script Engine
Script Engine scripts are installed in the Downloaded subfolder of the Excalidraw Automate script folder specified in plugin settings.
In the Command Palette installed scripts are prefixed with Downloaded/, thus you can always know if you are executing a local script of your own, or one that you have downloaded from GitHub.
Attention developers and hobby hackers
If you want to modify scripts, I recommend moving them to the `Excalidraw Automate script folder` or a different subfolder under the script folder. Scripts in the `Downloaded` folder will be overwritten when you click the `Update this script` button. Note also, that at this time, I do not check if the script file has been updated on GitHub, thus the `Update this script` button is always visible once you have installed a script, not only when an update is available (hope to build this feature in the future).
I would love to include your contribution in the script library. If you have a script of your own that you would like to share with the community, please open a PR on GitHub. Be sure to include the following in your pull request
- The script file with a self explanetory name. The name of the file will be the name of the script in the Command Palette.
- An image explaining the scripts purpose. Remember a picture speaks thousand words!
- An update to this file ea-scripts/index-new.md
List of available scripts
Layout and Organization
Keywords: Design, Placement, Arrangement, Structure, Formatting, Alignment
Connectors and Arrows
Keywords: Links, Relations, Paths, Direction, Flow, Connections
Text Manipulation
Keywords: Editing, Font Control, Wording, Typography, Annotation, Modification
Styling and Appearance
Keywords: Design, Look, Visuals, Graphics, Aesthetics, Presentation
Linking and Embedding
Keywords: Attach, Incorporate, Integrate, Associate, Insert, Reference
Utilities and Tools
Keywords: Functionalities, Instruments, Helpers, Aids, Features, Enhancements
Collaboration and Export
Keywords: Sharing, Teamwork, Exporting, Distribution, Cooperative, Publish
Conversation and Creation
Keywords: Transform, Generate, Craft, Produce, Change, Originate
Masking and cropping
Keywords: Crop, Mask, Transform images
Description and Installation
Add Connector Point
| Author | @zsviczian |
| Source | File on GitHub |
| Description | This script will add a small circle to the top left of each text element in the selection and add the text and the "connector point" to a group. You can use the connector points to link text elements with an arrow (in for example a Wardley Map).
 |
Add Link to Existing File and Open
| Author | @zsviczian |
| Source | File on GitHub |
| Description | Prompts for a file from the vault. Adds a link to the selected element pointing to the selected file. You can control in settings to open the file in the current active pane or an adjacent pane.
 |
Add Link to New Page and Open
| Author | @zsviczian |
| Source | File on GitHub |
| Description | Prompts for filename. Offers option to create and open a new Markdown or Excalidraw document. Adds link pointing to the new file, to the selected objects in the drawing. You can control in settings to open the file in the current active pane or an adjacent pane.
 |
Add Next Step in Process
| Author | @zsviczian |
| Source | File on GitHub |
| Description | This script will prompt you for the title of the process step, then will create a stick note with the text. If an element is selected then the script will connect this new step with an arrow to the previous step (the selected element). If no element is selected, then the script assumes this is the first step in the process and will only output the sticky note with the text that was entered.
 |
Auto Layout
| Author | @1-2-3 |
| Source | File on GitHub |
| Description | This script performs automatic layout for the selected top-level grouping objects. It is powered by elkjs and needs to be connected to the Internet.
 |
Boolean Operations
| Author | @GColoy |
| Source | File on GitHub |
| Description | With This Script it is possible to make boolean Operations on Shapes.
The style of the resulting shape will be the style of the highest ranking Element that was used.
The ranking of the elements is based on their background. The "denser" the background, the higher the ranking (the order of backgroundstyles is shown below). If they have the same background the opacity will decide. If thats also the same its decided by the order they were created.
The ranking is also important for the difference operation, so a transparent object for example will cut a hole into a solid object.
 |
Box Each Selected Groups
| Author | @1-2-3 |
| Source | File on GitHub |
| Description | This script will add encapsulating boxes around each of the currently selected groups in Excalidraw.
 |
Box Selected Elements
| Author | @zsviczian |
| Source | File on GitHub |
| Description | This script will add an encapsulating box around the currently selected elements in Excalidraw.
 |
Change shape of selected elements
| Author | @zsviczian |
| Source | File on GitHub |
| Description | The script allows you to change the shape and fill style of selected Rectangles, Diamonds, Ellipses, Lines, Arrows and Freedraw.
 |
Concatenate lines
| Author | @zsviczian |
| Source | File on GitHub |
| Description | This script will connect two objects with an arrow. If either of the objects are a set of grouped elements (e.g. a text element grouped with an encapsulating rectangle), the script will identify these groups, and connect the arrow to the largest object in the group (assuming you want to connect the arrow to the box around the text element).
 |
Connect elements
| Author | @zsviczian |
| Source | File on GitHub |
| Description | This script will connect two objects with an arrow. If either of the objects are a set of grouped elements (e.g. a text element grouped with an encapsulating rectangle), the script will identify these groups, and connect the arrow to the largest object in the group (assuming you want to connect the arrow to the box around the text element).
 |
Convert freedraw to line
| Author | @zsviczian |
| Source | File on GitHub |
| Description | Convert selected freedraw objects into editable lines. This will allow you to adjust your drawings by dragging line points and will also allow you to select shape fill in case of enclosed lines. You can adjust conversion point density in settings.
 |
Convert selected text elements to sticky notes
| Author | @zsviczian |
| Source | File on GitHub |
| Description | Converts selected plain text elements to sticky notes with transparent background and transparent stroke color (default setting, can be changed in plugin settings). Essentially converts text element into a wrappable format.
 |
Convert text to link with folder and alias
| Author | @zsviczian |
| Source | File on GitHub |
| Description | Converts text elements to links pointing to a file in a selected folder and with the alias set as the original text. The script will prompt the user to select an existing folder from the vault.
original text - [[selected folder/original text|original text]] |
Copy Selected Element Styles to Global
| Author | @1-2-3 |
| Source | File on GitHub |
| Description | This script will copy styles of any selected element into Excalidraw's global styles.
 |
Create DrawIO file
Create new markdown file and embed into active drawing
| Author | @zsviczian |
| Source | File on GitHub |
| Description | The script will prompt you for a filename, then create a new markdown document with the file name provided, open the new markdown document in an adjacent pane, and embed the markdown document into the active Excalidraw drawing.
 |
Crop Vintage Mask
| Author | @zsviczian |
| Source | File on GitHub |
| Description | Adds a rounded mask to the image by adding a full cover black mask and a rounded rectangle white mask. The script is also useful for adding just a black mask. In this case, run the script, then delete the white mask and add your custom white mask.
 |
Custom Zoom
| Author | @zsviczian |
| Source | File on GitHub |
| Description | You can set a custom zoom level with this script. This allows you to set a zoom level below 10% or set the zoom level to a specific value. Note however, that Excalidraw has a bug under 10% zoom... a phantom copy of your image may appear on screen. If this happens, increase the zoom and the phantom should disappear, if it doesn't, then close and open the drawing. |
Darken background color
| Author | @1-2-3 |
| Source | File on GitHub |
| Description | This script darkens the background color of the selected element by 2% at a time. You can use this script several times until you are satisfied. It is recommended to set a shortcut key for this script so that you can quickly try to DARKEN and LIGHTEN the color effect. In contrast to the `Modify background color opacity` script, the advantage is that the background color of the element is not affected by the canvas color, and the color value does not appear in a strange rgba() form.
 |
Deconstruct selected elements into new drawing
| Author | @zsviczian |
| Source | File on GitHub |
| Description | Select some elements in the scene. The script will take these elements and move them into a new Excalidraw file, and open that file. The selected elements will also be replaced in your original drawing with the embedded Excalidraw file (the one that was just created). You will be prompted for the file name of the new deconstructed image. The script is useful if you want to break a larger drawing into smaller reusable parts that you want to reference in multiple drawings.
 |
Elbow connectors
Ellipse Selected Elements
| Author | @mazurov |
| Source | File on GitHub |
| Description | This script will add an encapsulating ellipse around the currently selected elements in Excalidraw.
 |
Excalidraw Collaboration Frame
| Author | @1-2-3 |
| Source | File on GitHub |
| Description | Creates a new Excalidraw.com collaboration room and places the link to the room on the clipboard. |
Expand rectangles horizontally keep text centered
| Author | @1-2-3 |
| Source | File on GitHub |
| Description | This script expands the width of the selected rectangles until they are all the same width and keep the text centered.
 |
Expand rectangles horizontally
| Author | @1-2-3 |
| Source | File on GitHub |
| Description | This script expands the width of the selected rectangles until they are all the same width.
|
Expand rectangles vertically keep text centered
| Author | @1-2-3 |
| Source | File on GitHub |
| Description | This script expands the height of the selected rectangles until they are all the same height and keep the text centered.
|
Expand rectangles vertically
| Author | @1-2-3 |
| Source | File on GitHub |
| Description | This script expands the height of the selected rectangles until they are all the same height.
|
Fixed horizontal distance between centers
| Author | @1-2-3 |
| Source | File on GitHub |
| Description | This script arranges the selected elements horizontally with a fixed center spacing.
 |
Fixed inner distance
| Author | @1-2-3 |
| Source | File on GitHub |
| Description | This script arranges selected elements and groups with a fixed inner distance.
 |
Fixed spacing
| Author | @1-2-3 |
| Source | File on GitHub |
| Description | The script arranges the selected elements horizontally with a fixed spacing. When we create an architecture diagram or mind map, we often need to arrange a large number of elements in a fixed spacing. `Fixed spacing` and `Fixed vertical Distance` scripts can save us a lot of time.
 |
Fixed vertical distance between centers
| Author | @1-2-3 |
| Source | File on GitHub |
| Description | This script arranges the selected elements vertically with a fixed center spacing.
 |
Fixed vertical distance
| Author | @1-2-3 |
| Source | File on GitHub |
| Description | The script arranges the selected elements vertically with a fixed spacing. When we create an architecture diagram or mind map, we often need to arrange a large number of elements in a fixed spacing. `Fixed spacing` and `Fixed vertical Distance` scripts can save us a lot of time.
 |
Folder Note Core - Make Current Drawing a Folder
| Author | @zsviczian |
| Source | File on GitHub |
| Description | This script adds the `Folder Note Core: Make current document folder note` function to Excalidraw drawings. Running this script will convert the active Excalidraw drawing into a folder note. If you already have embedded images in your drawing, those attachments will not be moved when the folder note is created. You need to take care of those attachments separately, or convert the drawing to a folder note prior to adding the attachments. The script requires the Folder Note Core plugin. |
Golden Ratio
| Author | @zsviczian |
| Source | File on GitHub |
| Description | The script performs two different functions depending on the elements selected in the view.
1) In case you select text elements, the script will cycle through a set of font scales. First the 2 larger fonts following the Fibonacci sequence (fontsize * φ; fonsize * φ^2), then the 2 smaller fonts (fontsize / φ; fontsize / φ^2), finally the original size, followed again by the 2 larger fonts. If you wait 2 seconds, the sequence clears and starts from which ever font size you are on. So if you want the 3rd larges font, then toggle twice, wait 2 sec, then toggle again.
2) In case you select a single rectangle, the script will open the "Golden Grid", "Golden Spiral" window, where you can set up the type of grid or spiral you want to insert into the document.
|
Grid selected images
| Author | @7flash |
| Source | File on GitHub |
| Description | This script arranges selected images into compact grid view, removing gaps in-between, resizing when necessary and breaking into multiple rows/columns.
 |
ExcaliAI
Excalidraw Writing Machine
| Author | @zsviczian |
| Source | File on GitHub |
| Description | Creates a hierarchical Markdown document out of a visual layout of an article that can be fed to Templater and converted into an article using AI for Templater.
Watch this video to understand how the script is intended to work:
You can download the sample Obsidian Templater file from here. You can download the demo PDF document showcased in the video from here. |
Full-Year Calendar Generator
GPT Draw-a-UI
| Author | @zsviczian |
| Source | File on GitHub |
| Description | This script was discontinued in favor of ExcaliAI. Draw a UI and let GPT create the code for you.
 |
Image Occlusion
| Author | @TrillStones |
| Source | File on GitHub |
| Description | An Excalidraw script for creating Anki image occlusion cards in Obsidian, similar to Anki's Image Occlusion Enhanced add-on but integrated into your Obsidian workflow.
 |
Invert colors
| Author | @zsviczian |
| Source | File on GitHub |
| Description | The script inverts the colors on the canvas including the color palette in Element Properties.
 |
Lighten background color
| Author | @1-2-3 |
| Source | File on GitHub |
| Description | This script lightens the background color of the selected element by 2% at a time. You can use this script several times until you are satisfied. It is recommended to set a shortcut key for this script so that you can quickly try to DARKEN and LIGHTEN the color effect.In contrast to the `Modify background color opacity` script, the advantage is that the background color of the element is not affected by the canvas color, and the color value does not appear in a strange rgba() form.
|
Mindmap connector
| Author | @xllowl |
| Source | File on GitHub |
| Description | This script creates mindmap like lines (only right side and down available currently) for selected elements. The line will start according to the creation time of the elements. So you should create the header element first.
 |
Mindmap format
| Author | @pandoralink |
| Source | File on GitHub |
| Description | Automatically formats a mindmap from left to right based on the creation sequence of arrows.
A mindmap is actually a tree, so you must have a root node. The script will determine the leftmost element of the selected element as the root element (the node must be a rectangle, diamond, ellipse, text, image, but it can't be an arrow, line, freedraw, or group)
The element connecting node and node must be an arrow and have the correct direction, e.g. parent node -> child node.
The order of nodes in the Y axis or vertical direction is determined by the creation time of the arrow connecting it.
If you want to readjust the order, you can delete arrows and reconnect them.
The script provides options to adjust the style of the mindmap. Options are at the bottom of excalidraw plugin options (Settings -> Community plugins -> Excalidraw -> drag to bottom).
Since the start bingding and end bingding of the arrows are easily disconnected from the node, if there are unformatted parts, please check the connection and use the script to reformat. |
Modify background color opacity
| Author | @1-2-3 |
| Source | File on GitHub |
| Description | This script changes the opacity of the background color of the selected boxes. The default background color in Excalidraw is so dark that the text is hard to read. You can lighten the color a bit by setting transparency. And you can tweak the transparency over and over again until you're happy with it. Although excalidraw has the opacity option in its native property Settings, it also changes the transparency of the border. Use this script to change only the opacity of the background color without affecting the border.
 |
Normalize Selected Arrows
| Author | @1-2-3 |
| Source | File on GitHub |
| Description | This script will reset the start and end positions of the selected arrows. The arrow will point to the center of the connected box and will have a gap of 8px from the box.
 |
Organic Line
| Author | @zsviczian |
| Source | File on GitHub |
| Description | Converts selected freedraw lines such that pencil pressure will decrease from maximum to minimum from the beginning of the line to its end. The resulting line is placed at the back of the layers, under all other items. Helpful when drawing organic mindmaps.
The script has been superseded by Custom Pens that you can enable in plugin settings. Find out more by watching this video |
Organic Line Legacy
| Author | @zsviczian |
| Source | File on GitHub |
| Description | Converts selected freedraw lines such that pencil pressure will decrease from maximum to minimum from the beginning of the line to its end. The resulting line is placed at the back of the layers, under all other items. Helpful when drawing organic mindmaps.
This is the old script from this video. Since it's release this has been superseded by custom pens that you can enable in plugin settings. For more on custom pens, watch this
The benefit of the approach in this implementation of custom pens is that it will look the same on excalidraw.com when you copy your drawing over for sharing with non-Obsidian users. Otherwise custom pens are faster to use and much more configurable.
 |
Palette Loader
| Author | @zsviczian |
| Source | File on GitHub |
| Description | Design your palette at paletton.com Once you are happy with your colors, click Tables/Export in the bottom right of the screen. Then click "Color swatches/as Sketch Palette", and copy the contents of the page to a markdown file in the palette folder of your vault (default is Excalidraw/Palette)
 |
PDF Page Text to Clipboard
Relative Font Size Cycle
| Author | @zsviczian |
| Source | File on GitHub |
| Description | The script will cycle through S, M, L, XL font sizes scaled to the current canvas zoom. |
Rename Image
| Author | @zsviczian |
| Source | File on GitHub |
| Description | Select an image on the canvas and run the script. You will be prompted to provide a new filename / filepath. This cuts down the time to name images you paste from the web or drag and drop from your file system.
 |
Repeat Elements
| Author | @1-2-3 |
| Source | File on GitHub |
| Description | This script will detect the difference between 2 selected elements, including position, size, angle, stroke and background color, and create several elements that repeat these differences based on the number of repetitions entered by the user.
 |
Repeat Texts
| Author | @soraliu |
| Source | File on GitHub |
| Description | In the following script, we address the concept of repetition through the lens of numerical progression. As visualized by the image, where multiple circles each labeled with an even task number are being condensed into a linear sequence, our script will similarly iterate through a set of numbers |
Reverse arrows
| Author | @zsviczian |
| Source | File on GitHub |
| Description | Reverse the direction of **arrows** within the scope of selected elements.
 |
Scribble Helper
| Author | @zsviczian |
| Source | File on GitHub |
| Description | iOS scribble helper for better handwriting experience with text elements. If no elements are selected then the creates a text element at pointer position and you can use the edit box to modify the text with scribble. If a text element is selected then opens the input prompt where you can modify this text with scribble.
|
Select Elements of Type
| Author | @zsviczian |
| Source | File on GitHub |
| Description | Prompts you with a list of the different element types in the active image. Only elements of the selected type will be selected on the canvas. If nothing is selected when running the script, then the script will process all the elements on the canvas. If some elements are selected when the script is executed, then the script will only process the selected elements.
The script is useful when, for example, you want to bring to front all the arrows, or want to change the color of all the text elements, etc.
 |
Select Similar Elements
| Author | @zsviczian |
| Source | File on GitHub |
| Description | This script allows you to streamline your Obsidian-Excalidraw workflows by enabling the selection of elements based on similar properties. you can precisely define which attributes such as stroke color, fill style, font family, and more, should match for selection. It's perfect for large canvases where manual selection would be cumbersome. You can either run the script to find and select matching elements across the entire scene, or define a specific group of elements to apply the selection criteria within a defined timeframe.
 |
Reset LaTeX Size
| Author | @firai |
| Source | File on GitHub |
| Description | Reset the sizes of embedded LaTeX equations to the default sizes or a multiple of the default sizes.
 |
Set background color of unclosed line object by adding a shadow clone
| Author | @zsviczian |
| Source | File on GitHub |
| Description | Use this script to set the background color of unclosed (i.e. open) line and freedraw objects by creating a clone of the object. The script will set the stroke color of the clone to transparent and will add a straight line to close the object. Use settings to define the default background color, the fill style, and the strokeWidth of the clone. By default the clone will be grouped with the original object, you can disable this also in settings.
 |
Set Dimensions
| Author | @zsviczian |
| Source | File on GitHub |
| Description | Currently there is no way to specify the exact location and size of objects in Excalidraw. You can bridge this gap with the following simple script.
 |
Set Font Family
| Author | @zsviczian |
| Source | File on GitHub |
| Description | Sets font family of the text block (Virgil, Helvetica, Cascadia). Useful if you want to set a keyboard shortcut for selecting font family.
 |
Set Grid
| Author | @zsviczian |
| Source | File on GitHub |
| Description | The default grid size in Excalidraw is 20. Currently there is no way to change the grid size via the user interface. This script offers a way to bridge this gap.
 |
Set Link Alias
| Author | @zsviczian |
| Source | File on GitHub |
| Description | Iterates all of the links in the selected TextElements and prompts the user to set or modify the alias for each link found.
 |
Set Stroke Width of Selected Elements
| Author | @zsviczian |
| Source | File on GitHub |
| Description | This script will set the stroke width of selected elements. This is helpful, for example, when you scale freedraw sketches and want to reduce or increase their line width.
 |
Set Text Alignment
| Author | @zsviczian |
| Source | File on GitHub |
| Description | Sets text alignment of text block (cetner, right, left). Useful if you want to set a keyboard shortcut for selecting text alignment.
 |
Shade Master
| Author | @zsviczian |
| Source | File on GitHub |
| Description | You can modify the colors of SVG images, embedded files, and Excalidraw elements in a drawing by changing Hue, Saturation, Lightness and Transparency; and if only a single SVG or nested Excalidraw drawing is selected, then you can remap image colors.
|
Slideshow
Split Ellipse
| Author | @GColoy |
| Source | File on GitHub |
| Description | This script splits an ellipse at any point where a line intersects it. If no lines are selected, it will use every line that intersects the ellipse. Otherwise, it will only use the selected lines. If there is no intersecting line, the ellipse will be converted into a line object.
There is also the option to close the object along the cut, which will close the cut in the shape of the line.
Tip: To use an ellipse as the cutting object, you first have to use this script on it, since it will convert the ellipse into a line. |
Split text by lines
| Author | @zsviczian |
| Source | File on GitHub |
| Description | Split lines of text into separate text elements for easier reorganization
 |
Text Aura
| Author | @zsviczian |
| Source | File on GitHub |
| Description | Select a single text element, or a text element in a container. The container must have a transparent background.
The script will add an aura to the text by adding 4 copies of the text each with the inverted stroke color of the original text element and with a very small X and Y offset. The resulting 4 + 1 (original) text elements or containers will be grouped.
If you copy a color string on the clipboard before running the script, the script will use that color instead of the inverted color.
 |
Text to Path
| Author | @zsviczian |
| Source | File on GitHub |
| Description | This script allows you to fit a text element along a selected path: line, arrow, freedraw, ellipse, rectangle, or diamond. You can select either a path or a text element, or both:
- If only a path is selected, you will be prompted to provide the text.
- If only a text element is selected and it was previously fitted to a path, the script will use the original path if it is still present in the scene.
- If both a text and a path are selected, the script will fit the text to the selected path.
If the path is a perfect circle, you will be prompted to choose whether to fit the text above or below the circle.
After fitting, the text will no longer be editable as a standard text element or function as a markdown link. Emojis are not supported.
 |
Toggle Grid
| Author | @GColoy |
| Source | File on GitHub |
| Description | Toggles the grid on and off.
Especially useful when drawing with just a pen without a mouse or keyboard, as toggling the grid by left-clicking with the pen is sometimes quite tedious. |
Text to Sticky Notes
| Author | @zsviczian |
| Source | File on GitHub |
| Description | Converts selected plain text element to sticky notes by dividing the text element line by line into separate sticky notes. The color of the stikcy note as well as the arrangement of the grid can be configured in plugin settings.
 |
Uniform Size
| Author | @zsviczian |
| Source | File on GitHub |
| Description | 
The script will standardize the sizes of rectangles, diamonds and ellipses adjusting all the elements to match the largest width and height within the group. |
Printable Layout Wizard
| Author | @zsviczian |
| Source | File on GitHub |
| Description | Export Excalidraw to PDF Pages: Define printable page areas using frames, then export each frame as a separate page in a multi-page PDF. Perfect for turning your Excalidraw drawings into printable notes, handouts, or booklets. Supports standard and custom page sizes, margins, and easy frame arrangement.
 |
Zoom to Fit Selected Elements
