Set Embed Width and Height
Set the width and height of media embeds with link size syntax and Style Settings.
Use embed size syntax when a video embed looks too large or too small in your note. These work alongside hash properties like #t= and #loop on the same link.
Set the size on an internal embed
Add |widthxheight after the file name in the embed link. The first number is the width in pixels, the second is the height.
![[Lecture.mp4|640x360]]This creates a 640 px wide, 360 px tall embed.
Set only the width
Use a single number to set just the width. The embed keeps the media's aspect ratio.
![[Lecture.mp4|480]]The maximum embed height setting still applies.
Set only the height
Use xheight when the width can stay flexible but the video should stop at a specific height.
![[Lecture.mp4|x360]]The embed still uses the available note width, but won't grow taller than 360 px.
Set the size on an external embed
For a Markdown embed, put the size in the alt text before the URL. You can use widthxheight, width, or xheight.
If you also want alt text, add it before the size and separate them with |.
Adjust the maximum video height
Video embeds have a maximum height so they don't take over the note. The default is 60vh (60% of the Obsidian window height).
To change it:
- Install and enable the Style Settings community plugin
- Open Settings → Style Settings → Media Extended Settings
- Find Media Embed Settings
- Change Maximum Embed Height
You can use any CSS height value, like 480px or 70vh.
Adjust the minimum embed width
Media Extended sets a minimum embed width so players stay usable in narrow notes and table cells.
In Settings → Style Settings → Media Extended Settings → Media Embed Settings, you'll find three values:
- Minimum Embed Width is the shared default for all media embeds (
400px). - Minimum Video Embed Width overrides it for video only.
- Minimum Audio Embed Width overrides it for audio only.
Leave the video or audio-specific value empty to fall back to the shared default.
Note that a large size like |1920x1080 will shrink if it exceeds your configured maximum height.
See also
- Left-Align Video Embeds — align narrow embeds to the left instead of centering
- Hash Properties — other properties you can add to media links
- Frontmatter Properties — control playback behavior from a media note's frontmatter