Videos

Embed videos from YouTube, Vimeo, or local files with responsive aspect ratio handling.

YouTube

Syntax:

:::video{src="https://www.youtube.com/watch?v=VIDEO_ID"}
:::

Supported YouTube URL formats:

• youtube.com/watch?v=ID
• youtu.be/ID
• youtube.com/embed/ID

Vimeo

:::video{src="https://vimeo.com/VIDEO_ID"}
:::

Local Video

:::video{src="assets/demo.mp4"}
:::

Best Practices

• Use YouTube's privacy-enhanced mode URLs when possible
• Always provide a title for accessibility
• Keep videos relevant and concise --- supplement text, don't replace it
• For tutorials, pair video embeds with written steps below