Sync Embeds transforms standard Obsidian transclusions into live, editable, two-way synced blocks. Edit any note (or specific header section) directly from where you embed it, without ever needing to open the source file.
Trusted by over 15,000 users, it's designed to feel seamless, stable, and completely native to the Obsidian experience.
demo.mp4
Edit any embed, anywhere, and have it instantly save to the original note.
- 🔄 Live "Two-Way Syncing" — Edit an embed and see the changes reflected in the source note instantly. No "saving," no lag, no context switching.
- ⌨️ Full Keyboard Shortcut Support — The #1 limitation of native embeds is solved. Use all your familiar hotkeys for checkboxes (
Ctrl/Cmd+L), formatting (Ctrl/Cmd+B/I), lists, and headers, directly within an embed. - 🎯 Section & Header Embeds — Isolate and edit just a single section from a note using the standard
![[My Note#My Header]]syntax. Perfect for managing active tasks from a central dashboard. - 🚀 Dynamic Patterns (For Daily Notes) — Create embeds that automatically update based on dates or note titles (e.g.,
{{date}}). - 🎨 Smart Header Management — Section embeds intelligently enforce header hierarchy to prevent your markdown structure from breaking.
- 🎭 Custom Display Names — Show friendly aliases instead of raw file paths for cleaner, more readable page elements.
Instead of just rendering a read-only preview, Sync Embeds creates a hidden, fully functional editor pane for the source note. It then seamlessly "re-parents" the visual part of that editor directly into your current document.
This means you are interacting with a real editor instance. When editing a specific section, an intelligent viewport system restricts editing to only the target header while maintaining full synchronization with the source file.
Sync Embeds is officially available in the Obsidian Community Store!
- Open Obsidian Settings → Community Plugins.
- Click Browse and search for
Sync Embeds. - Click Install, then Enable.
- Go to the latest release.
- Download
main.js,manifest.json, andstyles.css. - In your Obsidian vault, navigate to
.obsidian/plugins/. - Create a new folder named
sync-embedsand paste the downloaded files inside. - Restart Obsidian, then enable the plugin under Settings → Community plugins.
Using Sync Embeds is simple. Wrap your standard embed syntax inside a sync code block.
```sync
![[My Note To Edit]]
```Isolate and edit a specific header:
```sync
![[Project Alpha#Active Tasks]]
```Create embeds that automatically adapt to the current context. Perfect for templating!
```sync
![[Daily/{{date:YYYY-MM-DD}}|Today's Note]]
![[Tasks#{{date-7d:YYYY-MM-DD}}|Last Week's Tasks]]
![[Projects/{{title}}#Notes|Project Notes]]
```Available dynamic variables:
{{date:FORMAT}}— Current date (e.g.,YYYY-MM-DD,DD MMM YYYY){{date±Xu:FORMAT}}— Date offsets:d(days),w(weeks),m(months),y(years){{time:FORMAT}}— Current time (e.g.,HH:mm,hh:mm A){{title}}— Current note's title
Override global settings for individual embeds right in the alias:
```sync
![[Long Note|Compact View{height:300px}]]
![[Reference|Full Height{maxHeight:none,title:false}]]
```Available options:
height— Set fixed height (e.g.,400px,60vh)maxHeight— Set maximum height before scrollingtitle— Show/hide title (trueorfalse)
Keep your daily note clean while managing recurring items:
```sync
![[Daily/{{date:YYYY-MM-DD}}|📅 Today]]
![[Daily/{{date-1d:YYYY-MM-DD}}|Yesterday]]
![[Master Tasks#{{date:YYYY-MM-DD}}|Today's Tasks]]
```View and edit different parts of a large project from a single pane:
```sync
![[Projects/{{title}}#Overview|Summary{height:300px}]]
![[Projects/{{title}}#Tasks|Active Tasks]]
![[Projects/{{title}}#Notes|Latest Notes]]
```This plugin was built with and for the community. If you find a bug, have a feature idea, or want to contribute, please feel free to open an issue or submit a pull request!
- Issues & Bug Reports: GitHub Issues
- Feature Requests: GitHub Discussions
