Get AI summaries of any video or article — Sign up free
Start using the flipside of your markdown notes: Powerful new Excalidraw-Obsidian features - v2.0.26 thumbnail

Start using the flipside of your markdown notes: Powerful new Excalidraw-Obsidian features - v2.0.26

5 min read

Based on Zsolt's Visual Personal Knowledge Management's video on YouTube. If you like this content, support the original creators by watching, liking and subscribing to their content.

TL;DR

Excalidraw-Obsidian v2.0.26 enables dual-mode notes by saving Excalidraw drawings as Markdown and allowing toggling between drawing and Markdown views.

Briefing

Excalidraw-Obsidian v2.0.26 adds a “flip the page” workflow that lets any existing Markdown note behave like an Excalidraw drawing—while still preserving full Markdown searchability and editing. The core idea is simple but consequential: Excalidraw drawings saved in Obsidian can now be stored as Markdown, and users can toggle between a drawing view and a Markdown view on demand. That removes the old tradeoff between visual thinking and text-first PKM, turning each note into a two-sided artifact: a visual summary on one side and detailed links and notes on the other.

A new command converts existing Markdown notes into Excalidraw drawings. Users open a Markdown file, open Obsidian’s command palette (Ctrl/Cmd+P), and run “Convert markdown note to Excalidraw drawing.” After conversion, “Toggle between Excalidraw and markdown mode” switches the same note between views. For people who want the option everywhere, the plugin can also mass-convert notes, though the guidance is to do it gradually because the minimum Excalidraw markup is lightweight but the change still affects how files are managed.

The release also targets publishing and default behavior. If Excalidraw files should open as Markdown instead of drawings, the plugin introduces an “Excalidraw open MD” frontmatter property. For published pages, an Easter-egg-style hiding mechanism uses a double percent “%%” marker above text elements so the plugin can strip those markers on save and hide the Excalidraw markup on the web. There’s also a “force save” option (Ctrl+S) to ensure the drawing is written in the intended mode.

Under the hood, v2.0.26 introduces a minor file format change that improves manual readability and editing: a new “element links” section. That comes with a compatibility warning—files saved with v2.26 won’t fully work with earlier versions—so updating Excalidraw-Obsidian across devices is recommended.

Beyond flipping notes, the update upgrades embedded content. Markdown embeds can now reference sections from the back side of a drawing, enabling card-like layouts where the front and back each contribute headings and content. Users can add a “back of note card” via the context menu or command palette, then create Markdown embeds that reference those back-side sections; when switching to Markdown view, the new heading appears in the document. Similar functionality exists for “insert any file,” letting a Markdown section be pulled from another Excalidraw file.

Quality-of-life improvements include smoother editing (pressing Enter jumps into editing when an embeddable element is selected) and bug fixes for embedded element style settings. The release also adds image annotation: “Annotate image in Excalidraw” embeds an annotated Excalidraw version back into the original image location, with settings modeled after cropping.

Finally, users can reference frames by name—useful for authoring companion Markdown for slide-like presentations—and can use multiple Excalidraw templates by pointing the plugin to a templates folder. The result is a more flexible PKM system where visual cards, structured text, and publish-ready output can coexist without forcing a single mode.

Cornell Notes

Excalidraw-Obsidian v2.0.26 makes notes truly dual-mode by letting Excalidraw drawings be saved as Markdown and toggled between drawing and Markdown views. A new conversion command turns existing Markdown notes into Excalidraw drawings, while “Toggle between Excalidraw and markdown mode” switches back and forth without losing searchability. Publishing support improves with an “Excalidraw open MD” frontmatter option and a “%%” marker trick that hides Excalidraw markup on the web. The update also adds back-side section embedding in Markdown, image annotation (cropping-like settings), named frame references, and multiple templates via a templates folder. A small file format change introduces an “element links” section, with backward-compatibility implications for older plugin versions.

How does the “flip the page” workflow remove the visual-vs-text tradeoff in Obsidian PKM?

The plugin stores Excalidraw drawings in a way that can be viewed and edited as Markdown. Users can convert a Markdown note into an Excalidraw drawing, then use a command-palette toggle to switch between “Excalidraw” view and “Markdown” view. That means the same note can function as a visual card (for quick comprehension and connections) while still offering Markdown’s search and editing strengths for detailed notes and links.

What mechanisms control how an Excalidraw note opens and how it appears when published?

To open an Excalidraw file in Markdown by default, users add the frontmatter property “excalidraw open MD true.” For publishing, the plugin uses an Easter-egg marker: placing “%%” on the line right above text elements causes the plugin to remove those markers on the next open/save, hiding the Excalidraw markup on the web. A “force save” via Ctrl+S (Mac and Windows) can be used to ensure the intended output is written.

What changed in the file format, and why does it matter?

v2.0.26 adds a new section called “element links” to the Excalidraw-Obsidian file format, improving how the content can be read and edited manually. The tradeoff is backward compatibility: files saved with v2.26 won’t fully work with earlier versions. The practical takeaway is to update Excalidraw-Obsidian on all devices before relying on the new structure.

How do back-side sections and Markdown embeds work together now?

Markdown embeds can reference sections located on the back side of an Excalidraw drawing. Users can add a “back of note card” (via context menu or command palette), then create Markdown embeds that reference those back-side sections. When switching to Markdown view, the referenced heading appears in the Markdown document. A similar capability exists through “insert any file,” allowing a Markdown section to be pulled from another Excalidraw file.

What new visual annotation capability was added, and how is it different from simple cropping?

The plugin introduces “Annotate image in Excalidraw.” Users pick an image on Obsidian Canvas or inside a Markdown note, then run the command from the command palette to embed the image into Excalidraw for annotation. After annotation, the plugin replaces the image in its original location with the Excalidraw version. The feature includes settings similar to cropping, and the workflow is designed to keep the annotated result publish-ready.

Which features support structured presentations and reusable styling?

Users can reference frames by their names, which helps when authoring companion Markdown for Excalidraw presentations or printing slide-like content. For styling and export consistency, the plugin supports multiple templates: set a templates folder in plugin settings, and each file in that folder becomes a different template (e.g., one with normal fonts for readability, another with smaller export padding for image deconstruction).

Review Questions

  1. What steps would you take to convert an existing Markdown note into an Excalidraw drawing while keeping the ability to edit it as Markdown later?
  2. How do “excalidraw open MD true” and the “%%” marker affect default opening behavior and what viewers see on published pages?
  3. Why might the new “element links” section force you to update the plugin across all devices before sharing files?

Key Points

  1. 1

    Excalidraw-Obsidian v2.0.26 enables dual-mode notes by saving Excalidraw drawings as Markdown and allowing toggling between drawing and Markdown views.

  2. 2

    A new command converts existing Markdown notes into Excalidraw drawings, making it easy to add a visual “other side” without rebuilding notes from scratch.

  3. 3

    Frontmatter “excalidraw open MD true” controls whether Excalidraw files open in Markdown by default.

  4. 4

    A “%%” marker above text elements hides Excalidraw markup on published pages by stripping the markers on save.

  5. 5

    The file format now includes an “element links” section, improving manual readability but breaking full backward compatibility with earlier plugin versions.

  6. 6

    Markdown embeds can now reference back-side sections of a drawing, enabling card-like layouts where front and back content both surface in Markdown view.

  7. 7

    New capabilities include image annotation in Excalidraw, named frame references, and multiple templates via a templates folder setting.

Highlights

The update’s defining feature is a true flip workflow: convert Markdown to Excalidraw, then toggle back and forth between drawing and Markdown modes without losing structure.
Publishing gets practical fixes: “excalidraw open MD true” controls default view, while “%%” markers can hide Excalidraw markup on the web.
Back-side section embedding turns drawings into two-sided documents—Markdown can pull headings and content from the back of the card.
Image annotation now works like a replace-in-place pipeline: annotate in Excalidraw, then swap the annotated result back into the original image location.
Named frame references and multiple templates make Excalidraw drawings more reusable for presentations and consistent exports.

Topics

  • Excalidraw-Obsidian v2.0.26
  • Markdown Toggle
  • Publishing Markup Hiding
  • Back-Side Embeds
  • Image Annotation
  • Named Frames
  • Multiple Templates

Mentioned

  • Nicole Vandenberg