Excalidraw 2.4.1

This release includes an important fix that can result in your drawing being overwritten by another drawing. Please update to this version as soon as possible.

Fixed

• A problem where switching between two Excalidraw documents in the same tab could result in the content from the first document overwriting the second one, particularly when the first document was large. #1988
• Styling issue when Obsidian font size is set to the non-default value.
• Embedding a block reference ![[file#^block]] where the file is an excalidraw file incorrectly replaced the embedding with the image instead of the block of text.

New

• Improved SVG export to include only the necessary glyphs for .woff2 fonts, minimizing file sizes. Note that this feature is currently supported only for .woff2 files; other font formats like .ttf and .otf will be fully embedded, leading to larger SVG files. I recommend using .woff2 files whenever possible.

Excalidraw 2.4.1 Release Candidate 1

Fixed

• A problem where switching between two Excalidraw documents in the same tab could result in the content from the first document overwriting the second one, particularly when the first document was large. #1988
• Styling issue when Obsidian font size is set to the non-default value.
• Embedding a block reference ![[file#^block]] where the file is an excalidraw file incorrectly replaced the embedding with the image instead of the block of text.

New

• Improved SVG export to include only the necessary glyphs for .woff2 fonts, minimizing file sizes. Note that this feature is currently supported only for .woff2 files; other font formats like .ttf and .otf will be fully embedded, leading to larger SVG files. I recommend using .woff2 files whenever possible.

Excalidraw 2.4.0

See the notes for the beta release for a detailed list of changes in 2.4.0

---

Notice

There is a minor formatting issue when you set non-default font size in Obsidian > Appearance settings. I won't publish an update just because of this. If you are impacted, you can add the following CSS snippet under Obsidian > Appearance > CSS Snippets. Open the folder, create a file e.g. "excalidraw-style-tweak.css" and paste the below code save the file, update the list of snippets in Obsidian and enable this new snippet.

.excalidraw div[data-radix-popper-content-wrapper] > div > div.Island {
 max-width: 13rem !important;
}

.excalidraw .App-menu__left {
  width: 12.5rem !important;
}

---

New

• Flowcharts with CTRL/CMD+Arrow and ALT/OPT+Arrow keys
• Improved PDF Support
  • PDF++ cropped area paste
  • Import PDF into frames
• Element links with metadata
• Obisidan Hotkey overrides
• Support for Zotero style markdown links

QoL

• Much improved freedraw flow, less autosave glitches
• Link editor CTRL+Meta/(CTRL+CMD) + click or via the command palette "Open the image-link or LaTeX-formula editor.
• Improved search and search results
• Disable double tap ereaser activation in pen mode
• Single click editing of markdown embeddables
• Set grid size and frequency
• Improved paste
• Pan & Zoom while editing Text
• Save active too-state (e.g. tool-lock) with the drawing
• Show/hide "sword" splashscreen in new drawings

Fixed

• Duplicate line points when Alt+click adding new points in line editor- - Excalidraw Automate measureText, impacting gate placement in ExcaliBrain
• If a group includes a frame, the image reference will include all the elements in the frame, not just the frame
• Excalidraw rendering issues in markdown preview
• Markdown pages embedded in Excalidraw were broken
• Drawing did not save arrow type
• Fixed rendering of newly pasted links

ExcalidrawAutomate

• new functions
  • tex2dataURL
  • addElementsToFrame
  • resetImageAspectRatio
• Changed
  • getViewSelectedElements(includeFrameChildren: boolean = true);
  • getOriginalImageSize with option to wait for the image to load

2.4.0-rc-2

New

• Hotkey overrides in Plugin settings
• active tool will be saved with the drawing #1967
• new setting: Excalidraw appearance and behavior > Show splash screen in new drawings 1969
• Pan and Zoom while editing text

Excalidrw 2.4.0 release candidate 1

New

• New setting: "Single click to edit embedded markdown". (Plugin Settings > Embed files into Excalidraw > Interactive Markdown Files)

Fixed

• Links dragged from Zotero to Excalidraw are not recognized correctly #1963
• Embed preview of drawings in markdown notes is broken starting with 2.4.0-beta-7 on Android devices #1956

Excalidraw 2.4.0-beta-10

Performance

• Moved the JSON compressor to a separate worker thread, reducing glitches in freedraw performance during autosave.
• Refactored JSON manipulation in the load and save functions, further decreasing freedraw performance glitches when autosave runs.

Fixes

• Fixed two issues with pasting links and transclusions. These were not rendered correctly until the user pressed CTRL+S, and block references from the back-of-the-excalidraw file (i.e. self-references in the format of ![[#^blockRef]] triggered a warning message.
• Resolved a bug that caused Excalidraw to erroneously switch to markdown view mode when clicking a link (e.g., in backlinks or search) that should lead to an embedded image in the drawing.

New

• Pasting multiple lines of text with CTRL+V (not CTRL+Shift+V) now replaces any image embeds with actual images and shifts the pasted text downward to make room. This enables you to copy an entire markdown document and "convert" it into text elements and images in Excalidraw with a single CTRL+V action.
• Added Chinese ReadMe 🙏@dmscode

Housekeeping

• Refactored rollup.config.js and cleaned up/updated dependencies in package.json

Excalidraw 2.4.0-beta-9

Fixed

• The drawing did not save the type of arrow. e.g. if you were using elbow arrows, the next time you opened the drawing you had to select elbow arrows again.

New

• CTRL+F search in Excalidraw will also search in image file names

Performance

• Performance improvement for drawing freedraw lines hopefully results in significant improvement for drawings with many elements.

Refactor

• Excalidraw.com refactored the "Diagram to Code" AI feature. Hopefully, it will still work the same way it did before.

Excalidraw 2.4.0-beta-8

Fixed

• When the selection includes an elbow arrow the repositioning of the selected elements using the arrow keys is blocked unless the start and end elements binding to the arrow are also included in the selection #8387
• The context menu stopped working after editing properties with stats editor #8385
• Markdown pages embedded as an image (i.e. not using the interactive embeddable feature) did not display embedded Excalidraw images in the markdown page and did not display fonts correctly.
• I also fixed the input prompt to edit the markdown-image size. It was very unpredictable until now.
• When Obsidian search matches text from the markdown side of the document Excalidraw will switch to markdown view when navigating to the search result (by clicking on the line in Obsidian search). Until now switching to markdown only worked for sections and block references.

New

• Editable grid size and grid frequency in Canvas & Shape Properties. ⚠️ Note that until 2.4.0 is released the setGrid script will not be updated - and the current one will not work. However, you can use the new shape properties editor instead.
• BIG QoL: When searching for text in Excalidraw, the search result will be highlighted with bold selection borders.
• CTRL/CMD+F (search) in Excalidraw will also search element links.
• Element links now support #tags and (inline dataview:: [[links]]). This way you can assign ontology and tags to your drawing without impacting the visual look and feel of the document (as these metadata elements will be hidden from view in the element link). Searching for these in Excalidraw with CTRL/CMD+F or Obsidian's built-in search is also possible.
• Clicking Obsidian search results will highlight elements in the drawing even if multiple elements match the query. This is true for link-, tag-, and text-matches equally.
• CTRL+CMD+Click (Mac default) / CTRL+Meta+Click (Windows default): To edit the image-file link will open an editor window where you can also edit the link for the image or PDF. This way you can replace the image file with another link or add |100% to the end of the excalidraw-image to anchor its size or change the page= or rect= for the embedded PDF page, etc.
• New Command Palette action: Open the image-link or LaTeX-formula editor

New / changed in Excalidraw Automate

• ExcalidrawAutomate getTemplate returned an incorrect frontmatter when the template includes %% in front of # Excalidraw Data, this resulted in an error in the deconstructed file where the first text element got an additional ## Text Elements heading.
• getOriginalImageSize() has a new optional parameter to wait for the image to load into view
• resetImageAspectRatio() is a new utility function that resets the image to its original aspect ratio.
  • If the image is resized then the function returns true.
  • If the image element is not in EA (only in the view), then if the image is resized, the element is copied to EA for Editing using copyViewElementsToEAforEditing([imgEl]).
  • Note you need to run await ea.addElementsToView(false); to add the modified image to the view.",

async getOriginalImageSize(imageElement: ExcalidrawImageElement, shouldWaitForImage: boolean=false): Promise<{width: number; height: number}>;

async resetImageAspectRatio(imgEl: ExcalidrawImageElement): Promise<boolean>;

Excalidraw 2.4.0-beta-7

Fixed

• Markdown / PDF export rendering incorrectly rendered obsidian-tasks task-list as an image when it included tasks from an Excalidraw file

New

• Updated zh-cn translation 🙏 @dmscode
• Few experimental hyperlinks in Settings to improve navigation

Excalidraw 2.4.0-beta-6

New

• Setting under Appearance and Behavior to enable/disable double tap eraser in Pen mode. #1760

• Support for PDF++ page cropping. You can select a rectangular area in PDF++ then paste it to Excalidraw and the cropped area with a link back to the source will appear.

PDF++.Excalidraw.integration.page.cropping.mp4