Media Embed

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).

⭐️ Roadmap unlocks with GitHub stars:

• 100 GitHub ⭐ : more video providers (Vimeo, Dailymotion, local files…)
• 1 000 GitHub ⭐ : auto-import video metadata (title, thumbnail) from URL

Features

• intercepts YouTube URLs pasted on empty lines
  • youtu.be
  • shorts
  • embed URLs
• three preview options to choose from
  • simple markdown
  • responsive in iframe and div modes
• alternative embed server support for restricted videos
  • toggle in settings to route embeds through an Invidious instance
  • bypasses YouTube embed blocks (Error 153)
  • configurable URL — swap instances if one is down
• works 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

Not sure which to pick? See pros & cons and edge-case guide.

Alternative embed server

Some YouTube videos have embedding disabled by the uploader. When pasted in iframe or div mode, they show a blank player (YouTube Error 153).

Enable Use alternative embed server in settings to route embeds through an Invidious instance instead.

Results in source mode:

---

Usage

1. copy YouTube video URL (right-click on it: Copy video URL)
2. open any note
3. place your cursor on a blank line
4. paste the YouTube URL (Cmd+V / Ctrl+V)
5. 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

1. open Obsidian Settings... → Community plugins
2. disable Safe mode if prompted
3. click Browse and search for Media Embed
4. install and enable the plugin
5. open Options and choose your preferred style (markdown, iframe, div)

Manual

1. go to the latest release and download main.js and manifest.json
2. create a folder <your vault>/.obsidian/plugins/video-embed/
3. place both files in that folder
4. reload Obsidian and enable the plugin in Settings → Community plugins

---

Contributing

Found a bug or have a suggestion? You're welcome to open an issue. See CONTRIBUTING for development setup and pull request guidelines.

---

License

This project is licensed under MIT.

---

_{made with ⏳ by punkyard}