README file from
Github
Simply paste a YouTube URL on an empty line in an Obsidian note and it's instantly converted into your preferred embed format (markdown, iframe or div) — no commands, no shortcuts, just paste.
Features
- intercepts YouTube URLs pasted on empty lines
- three preview options to choose from
- simple markdown
- responsive in iframe and div modes
- working on desktop and mobile
Embed styles
Choose your preferred embed mode in Obsidian Settings... → Media Embed.

| Style | Output | Responsive |
|---|---|---|
| markdown | ![]() |
no — fixed size |
| iframe | <iframe ...> |
yes — fills pane width |
| div | <div><iframe ...> |
yes, in a frame — bulletproof |
Results in source mode:

Usage

- copy YouTube video URL (right-click on it: Copy video URL)
- open any note
- place your cursor on a blank line
- paste the YouTube URL (
Cmd+V/Ctrl+V) - the URL is automatically replaced with the embed
Supported URL formats:
https://www.youtube.com/watch?v=...https://youtu.be/...https://www.youtube.com/shorts/...https://www.youtube.com/embed/...
Installation
From Obsidian Community Plugins
- open Obsidian Settings... → Community plugins
- disable
Safe modeif prompted - click
Browseand search forMedia Embed - install and enable the plugin
- open
Optionsand choose your preferred style (markdown, iframe, div)
Manual
- download the source ZIP from the latest release
- unzip the archive into
<your vault>/.obsidian/plugins/ - reload Obsidian and enable the plugin in Obsidian Settings... → Community plugins
Roadmap
- v2 when repo hits 100 GitHub ⭐ — more video providers (Vimeo, Dailymotion, …)
- v3 when repo hits 1 000 GitHub ⭐ — import video metadata (title, thumbnail) from URL
Contributing
Found a bug or have a suggestion? Open an issue.
License
This project is licensed under GPL-3.0-or-later.
In practical terms, that means distributed modifications and derivative versions must also remain open source under GPL-compatible terms.