All posts
Allen
Author, Content Operations Manager·Originally published Oct 17, 2025 · Updated Oct 9, 2026
Freehand schoolyard sketch beside organized research cards, illustrating two ways of visual thinking

Excalidraw vs Obsidian: Canvas, Plugins and File Workflows

Choose Your Visual Thinking Path With Confidence

Choose Excalidraw for drawing an idea, Obsidian Canvas for arranging the notes behind it, and the Excalidraw plugin when you want editable sketches inside an Obsidian vault. These are three different tools, even though two can live in the same workspace.

  • Already have an Obsidian vault? Start with Canvas. Add the Excalidraw plugin if pen strokes, annotated sketches or custom shapes are important to your work.
  • Need a temporary diagram with other people? Start with standalone Excalidraw and its live collaboration room. Save an editable copy after the session.
  • Building a long-term research library? Keep evidence and conclusions in Markdown notes, arrange them in Canvas, and attach drawings where they explain something words cannot.

This guide follows one example: planning a schoolyard shade research project. It uses the same eight notes to show what each approach makes easier—and what you need to preserve when moving between them.

How We Evaluated Tools and Validated Features

This is a documentation-based comparison, checked on October 9, 2026 against the developers' documentation, repositories and plugin directory. The project below is an original teaching example with fictional observations, not a field study. Its diagrams are explanatory illustrations, not product screenshots. We do not claim device benchmarks, installation testing or a verified lossless round trip.

AFFiNE publishes this guide and offers a competing document-and-whiteboard workspace. Its use case appears near the end; it does not change the distinctions between the three tools.

Feature Parity and Workflow Outcomes at a Glance

QuestionStandalone ExcalidrawObsidian CanvasExcalidraw plugin for Obsidian
What is it?Web drawing editorCore plugin for arranging cardsCommunity integration of Excalidraw
Best starting materialA shape, sketch or visual explanationExisting notes and source filesA sketch that needs vault links
Editable storage.excalidraw JSON scene.canvas JSON layout plus referenced filesMarkdown drawing, commonly .excalidraw.md, plus dependencies
Pen drawingYesCard-and-connector workflow, not a freehand sketch editorYes
Notes and linksDrawing content and hyperlinksFile cards, text cards and web cardsVault-aware links and embeds
Offline boundaryPWA supports offline editing; prepare it before disconnectingLocal notes/files remain local; web cards still need their sitesLocal drawing; online integrations have separate requirements
SharingLive collaboration on excalidraw.comShare/sync the vault; no native same-file live editingDo not assume the web app's collaboration room is included
Portable viewPNG or SVGPreserve the board and its files; no image-export workflow documented in the cited Canvas helpPNG/SVG export for readers without the plugin

Sources: Excalidraw project overview, Canvas help, plugin documentation and Obsidian shared-vault limitations. A feature of excalidraw.com is not automatically a feature of every integration using its drawing editor.

Cost: the Excalidraw editor is free and open source. Obsidian is free to use, including at work; Sync and Publish are optional paid services. The Excalidraw community plugin is available without a plugin purchase. This example needs no paid service. Check Obsidian's current pricing when budgeting for shared vaults: every collaborator needs an active Sync subscription. Excalidraw+ is a separate offering and is outside this comparison.

One Research Project, Two Useful Layouts

The question is: Where should a school add shade for lunchtime seating? Use these eight files. The content is deliberately small enough to copy and replace with your own evidence.

FileExample note content
01-question.mdCompare the east bench and west court for a small shade pilot.
02-site.mdSketch two candidate seating areas; confirm dimensions before proposing a structure.
03-observation.mdFictional observation: the east bench is sunny at lunch; the west court has afternoon shade.
04-interview.mdFictional interview note: students want shaded seats close to the classroom exit.
05-options.mdCompare a tree, a shade sail and moving existing benches.
06-constraints.mdCheck underground services, access routes, maintenance and permission requirements.
07-decision.mdProvisional choice: investigate the east bench first; no installation decision yet.
08-next-steps.mdMeasure the site, repeat observations and ask facilities staff to review feasibility.

Download the research example ZIP. It contains these eight Markdown notes, a JSON Canvas board, a standalone Excalidraw scene and a README. The files are author-created examples; schema and file references were checked, but opening them in your installed app remains an acceptance step.

Layout A: sketch the spatial question

In Excalidraw, put the east bench and west court on opposite sides of a rough site outline. Add a sun and an arrow for the lunchtime observation. Place the interview beside the exit, and put the three options around the east bench. Circle the constraints that could rule an option out. Keep the provisional decision and next steps below the drawing.

The drawing lets you ask, “Does this proposed seat location make sense?” A curved arrow can express movement; a rough circle can mark uncertainty. Those marks do not need to become standalone research notes.

Layout B: arrange the evidence behind the decision

In Canvas, arrange notes 02–04 in an Evidence group, notes 05–06 in Options and limits, and notes 07–08 in Decision and follow-up. Put the question above them. Connect the observation and interview to the options, the constraints to the decision, and the decision to next steps.

Now ask, “What supports this decision, and what is missing?” The full note remains the place to record a source, its date and uncertainty. A card's position makes an argument easier to inspect; it does not prove that argument.

The same eight research notes arranged as a spatial sketch and an evidence-to-decision board
Original schematic. Both layouts use the same eight note IDs. The sketch emphasizes place and movement; the board emphasizes evidence, constraints and follow-up.

Keep one place for each substantive claim

Use Markdown for the observation and its source. In the sketch, write a short label such as “03: sunny at lunch,” then link back to that note when using the Obsidian plugin. Avoid maintaining two slightly different interview transcripts—one in a drawing and another in a note.

For a reusable decision note, copy this pattern:

# Provisional shade decision

Status: needs site verification

Investigate the east bench first.

Evidence: [[03-observation]] and [[04-interview]]
Options: [[05-options]]
Constraints still to check: [[06-constraints]]
Next action: [[08-next-steps]]

These are Obsidian wikilinks. Other Markdown readers may need standard Markdown links or conversion; plain text portability does not guarantee identical link behavior everywhere.

Obsidian Canvas

Canvas is the lower-setup choice when your material already consists of notes, PDFs, images and links. It is part of Obsidian's core plugin set, rather than a community drawing extension.

Step-by-Step: Build a Visual Map in Obsidian Canvas

  1. Create a Shade research folder and add the eight notes above. Alternatively, unzip the example and copy its Shade research folder into the root of a disposable vault.
  2. Use Canvas: Create new canvas, or open research.canvas from the example.
  3. Drag the existing note files into the board. Group and connect them using the arrangement above.
  4. Edit the decision in its note card; keep the evidence in its own file.
  5. Add a temporary text card for a question you have not resolved. If it becomes a durable note, use Convert to file.

You can embed the board in a note with ![[research.canvas]], but Obsidian documents that Canvas embeds show shapes without the text inside cards. Open the board itself to read the research. See Canvas embedding limits.

That last distinction matters: a Canvas text card stores text inside the board. It is not automatically a Markdown note, and text-only cards do not appear in backlinks until converted to files. See the Canvas card instructions.

Vault Storage and Sync Behavior

A .canvas file stores nodes, positions, connections and references using JSON Canvas. A file card points to a file; it does not pack that file's contents into the board. Copying only research.canvas leaves the example's Markdown references behind.

For a portable project folder, use this organization:

Shade research/
  01-question.md … 08-next-steps.md
  research.canvas
  Drawings/
    shade-options.excalidraw
  Exports/
    shade-options.svg

The download includes the editable source and an empty exports folder marker; create the SVG when you export. A plugin-created drawing would normally add shade-options.excalidraw.md under Drawings. It is a separate format, not a filename change to the standalone scene.

The included Canvas uses vault-relative paths starting with Shade research/. If you nest or rename that folder outside Obsidian, update its file references. Moving the whole folder to a different place without checking paths is not a complete migration.

Obsidian with Excalidraw Plugin

Use the plugin when drawing itself matters and you want that drawing connected to your vault. The official Obsidian plugin directory identifies its maintainer as zsviczian (Zsolt Viczián). It is a community project, not Obsidian's native Canvas and not a promise of feature parity with excalidraw.com.

Installation and First Run Checklist

  1. Back up the vault, or start in a disposable example vault.
  2. Open Settings → Community plugins. Enabling community plugins means leaving Restricted Mode.
  3. Search for Excalidraw, check the maintainer and linked repository, then install and enable it.
  4. Create a drawing using the plugin's command-palette action. Confirm its actual filename and save folder.
  5. Add a link to 03-observation and embed the drawing in 07-decision. Reopen both before moving important work into this setup.

Obsidian's plugin security documentation says plugins inherit the app's access levels: it cannot reliably grant each plugin a narrow set of permissions. A directory listing or automated scan is not a guarantee that a plugin is suitable for your organization's data policy. If community plugins are prohibited, use native Canvas and attach an exported drawing instead.

Linking and Embedding

A drawing label can use [[03-observation]] to reference a note. To show a drawing inside another note, use an embed such as:

![[Drawings/shade-options.excalidraw]]

Adjust the path to the drawing you actually created. The plugin resolves its Markdown drawing file; a reader without the plugin does not gain the same editable drawing view. Keep a PNG/SVG export for that audience. See the maintainer's embedding and link documentation.

What Is Inside the Drawing File?

The plugin stores drawings in Markdown with drawing data, often compressed, rather than merely saving a standalone .excalidraw JSON file. Its compatibility/export settings can also maintain a standalone scene. Preserve the Markdown drawing and any referenced attachments when backing up the vault; changing the extension cannot convert the contents.

Three editable file formats separated by editor, with their supporting notes, attachments and image exports
File and editor relationships, not a product screenshot. A layout, an editable drawing and a preview image serve different purposes.

Excalidraw App

Standalone Excalidraw is a useful starting point for the schoolyard sketch when collaborators do not share a vault. The official project documents real-time collaboration, browser autosave and offline PWA support. Online collaboration still needs a connection; browser-local saving is not cross-device backup.

For a short working session, draw together, agree on a provisional result, then save the editable .excalidraw scene and export a PNG or SVG for the meeting record. Put the conclusion and unresolved questions into the research notes afterward. Do not rely on a room link as your only archive.

For offline work, load the PWA while connected and confirm it reopens on the intended device before leaving. Save a file you control. A separate native desktop download is not required for this documented workflow: the official web app overview explicitly documents PWA offline support.

Storage, Export, and Interoperability

An image preserves a view; a source file preserves the editing structure appropriate to its tool. Keep both when a diagram needs to be shared and revised later.

MovePractical routeWhat needs checking
Web Excalidraw → Obsidian, view onlyExport PNG/SVG into the vault and embed the imageThe image does not become editable Canvas cards
Web Excalidraw → plugin editingUse the plugin's scene import/conversion workflow on a copy of the .excalidraw fileReopen it; inspect images, fonts and links
Plugin → web ExcalidrawExport a standalone .excalidraw scene using compatibility/export optionsVault links and note embeds need separate handling outside Obsidian
Canvas → another vaultCopy .canvas plus its referenced notes and attachmentsVault-relative paths, web embeds and missing files
Canvas → a drawingRebuild the visual or use a view-only captureNo native lossless Canvas-to-Excalidraw conversion is established here

An SVG can be a vector image without containing editable Excalidraw scene data. Excalidraw offers an option to embed scene data in image exports; availability of that data and the receiving tool determine whether it can be restored. Keep the .excalidraw source anyway. See the official image export implementation. The Obsidian plugin also documents SVG conversion with limitations; neither route justifies promising an arbitrary SVG will round-trip without loss.

Migration checklist: retain source, export a preview, move dependencies and verify links before replacing the original
Migration is a copy-and-check process. The source, preview and linked notes each preserve a different part of the project.

A Migration Check You Can Repeat

Keep the original untouched and work on a copy. Open the copy in the destination, then check:

  • Can you edit a shape and a text label, rather than just move one flattened image?
  • Do the observation and decision links reach the intended notes?
  • Are local images present, and which items still require the internet?
  • Does the exported preview show the full drawing without clipped labels?
  • Can you restore the original if the conversion omitted something?

For the example, check all eight notes and the two candidate locations. If the target only needs to read the result, a static export and a written decision may be enough. If it needs to continue the research, send the notes and editable source too.

Actionable Recommendations for Different Workflows

Existing Obsidian vault: use Canvas as the project's index. Add the community plugin only when editable drawings improve the work enough to justify its setup and maintenance. If you are still choosing your main note system, the Obsidian vs Notion comparison covers the broader decision.

Temporary collaborative diagram: use excalidraw.com, nominate someone to save the scene, and write down the conclusion. A shared Obsidian vault syncs files; its official collaboration guide explicitly says it does not provide live collaborative editing of the same file. Avoid simultaneous edits to the same research board or drawing through file sync.

Long-term research library: make Markdown notes the record of evidence, Canvas the navigation layer and drawings the visual explanations. Back up the whole project, including attachments. “Stored locally” does not mean “backed up,” and a successful file sync is not proof that all embedded content will work offline.

Formal diagramming tools and graph extensions such as ExcaliBrain address other needs. Neither is required to build the eight-note example. Add another tool only when you can name a specific missing capability.

Where AFFiNE Fits

If the central requirement is writing and arranging material on a whiteboard in one workspace, AFFiNE's whiteboard is another option to evaluate. For this project, that might mean keeping a shared planning document and visual discussion together. It is a different workspace choice, so check its current capabilities against your requirements; do not assume it imports an Obsidian vault or Excalidraw scene without loss.

If you already have a well-maintained vault and only need an occasional sketch, there is little reason to change the whole research system for this one task.

Excalidraw vs Obsidian: Frequently Asked Questions

Can you draw in Obsidian without the Excalidraw plugin?

Native Canvas lets you arrange cards and connect them. For freehand sketching, use a drawing integration such as the community Excalidraw plugin, or draw externally and embed an image. Canvas and Excalidraw serve different editing tasks.

Is the Excalidraw plugin an official Obsidian feature?

It is listed in Obsidian's community plugin directory and maintained by zsviczian. Canvas is a core Obsidian plugin. Installing a community plugin requires a separate trust decision and does not make its features native to Obsidian.

Can I use these tools offline?

Excalidraw documents offline PWA support. Obsidian keeps vault files locally, and the Excalidraw plugin supports local drawing. Web pages, remotely hosted images, collaboration and optional online integrations still need their respective connections. Check the actual project on the device you will use offline.

Can I import Excalidraw into Obsidian Canvas?

You can export a drawing as an image and place that image on a Canvas board. It remains an image card, not a set of native Canvas nodes. Use the community plugin when you need Excalidraw editing inside Obsidian, and retain the source scene.

Which files should I keep when moving a research project?

Keep the Markdown notes, .canvas board, editable drawing source and referenced attachments. Add PNG/SVG previews for recipients who lack the drawing tool. Verify paths and links after copying; no single export format preserves every feature across these tools.