
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.
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.
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.
| Question | Standalone Excalidraw | Obsidian Canvas | Excalidraw plugin for Obsidian |
|---|---|---|---|
| What is it? | Web drawing editor | Core plugin for arranging cards | Community integration of Excalidraw |
| Best starting material | A shape, sketch or visual explanation | Existing notes and source files | A sketch that needs vault links |
| Editable storage | .excalidraw JSON scene | .canvas JSON layout plus referenced files | Markdown drawing, commonly .excalidraw.md, plus dependencies |
| Pen drawing | Yes | Card-and-connector workflow, not a freehand sketch editor | Yes |
| Notes and links | Drawing content and hyperlinks | File cards, text cards and web cards | Vault-aware links and embeds |
| Offline boundary | PWA supports offline editing; prepare it before disconnecting | Local notes/files remain local; web cards still need their sites | Local drawing; online integrations have separate requirements |
| Sharing | Live collaboration on excalidraw.com | Share/sync the vault; no native same-file live editing | Do not assume the web app's collaboration room is included |
| Portable view | PNG or SVG | Preserve the board and its files; no image-export workflow documented in the cited Canvas help | PNG/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.
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.
| File | Example note content |
|---|---|
01-question.md | Compare the east bench and west court for a small shade pilot. |
02-site.md | Sketch two candidate seating areas; confirm dimensions before proposing a structure. |
03-observation.md | Fictional observation: the east bench is sunny at lunch; the west court has afternoon shade. |
04-interview.md | Fictional interview note: students want shaded seats close to the classroom exit. |
05-options.md | Compare a tree, a shade sail and moving existing benches. |
06-constraints.md | Check underground services, access routes, maintenance and permission requirements. |
07-decision.md | Provisional choice: investigate the east bench first; no installation decision yet. |
08-next-steps.md | Measure 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.
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.
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.
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.
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.
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.research.canvas from the example.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.
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.
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.
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.
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.
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.
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.
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.
| Move | Practical route | What needs checking |
|---|---|---|
| Web Excalidraw → Obsidian, view only | Export PNG/SVG into the vault and embed the image | The image does not become editable Canvas cards |
| Web Excalidraw → plugin editing | Use the plugin's scene import/conversion workflow on a copy of the .excalidraw file | Reopen it; inspect images, fonts and links |
| Plugin → web Excalidraw | Export a standalone .excalidraw scene using compatibility/export options | Vault links and note embeds need separate handling outside Obsidian |
| Canvas → another vault | Copy .canvas plus its referenced notes and attachments | Vault-relative paths, web embeds and missing files |
| Canvas → a drawing | Rebuild the visual or use a view-only capture | No 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.
Keep the original untouched and work on a copy. Open the copy in the destination, then check:
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.
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.
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.
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.
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.
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.
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.
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.