Excalidraw

When enabled, Quartz Syncer will sync Excalidraw drawings (.excalidraw.md files) to Quartz as-is. Rendering is handled by the Quartz Excalidraw plugin.

How it works

1. Detection: Quartz Syncer identifies files with the .excalidraw.md extension.
2. Syncing: The drawing file is synced to Quartz without modification.
3. Rendering: The Quartz Excalidraw plugin renders the drawing in Quartz, including dark/light theme support and interactive pan/zoom.

Requirements

• The Excalidraw plugin must be installed and enabled in Obsidian.
• The Quartz Excalidraw plugin must be installed in your Quartz site:

npx quartz plugin add github:quartz-community/obsidian-plugin-excalidraw

• Drawings must have the .excalidraw.md file extension.
• The drawing file must have excalidraw-plugin: parsed in its frontmatter (this is added automatically by the Excalidraw plugin).

Example

Drawing

+−⟲

🔗 quartz.jzhao.xyz

📄 Troubleshooting/Excalidraw

Open note →

Excalidraw usage

For questions regarding Excalidraw usage, please refer to the Excalidraw documentation.

For rendering issues in Quartz, please refer to the Quartz Excalidraw plugin.

Drawing does not appear in Quartz

If your Excalidraw drawing is not showing up on your Quartz site:

1. Ensure the Quartz Excalidraw plugin is installed - The plugin must be installed in your Quartz site for drawings to render. Install it with:

npx quartz plugin add github:quartz-community/obsidian-plugin-excalidraw

2. Ensure the Excalidraw integration is enabled - The Excalidraw integration must be enabled in Quartz Syncer’s settings for .excalidraw.md files to be synced.
3. Check the file extension - Drawing files should have the .excalidraw.md extension.
4. Verify the frontmatter - Excalidraw files should have excalidraw-plugin: parsed in their frontmatter.

Drawing appears but renders incorrectly

Rendering is handled by the Quartz Excalidraw plugin. If a drawing syncs successfully but doesn’t render correctly, please raise an issue on the Quartz Excalidraw plugin repository.

I have a different issue not listed here

For syncing issues, please raise an issue on GitHub.

For rendering issues, please raise an issue on the Quartz Excalidraw plugin repository.

Link to original

Notes

• Quartz Syncer syncs the raw .excalidraw.md file without any transformation.
• All rendering, theme support, and interactivity is handled by the Quartz Excalidraw plugin.
• For configuration options (dark mode, interactivity, padding), refer to the Quartz Excalidraw plugin documentation.