---
title: YouTube or Vimeo
slug: docs/youtube-or-vimeo
docTags:
createdAt: 2026-06-05T13:04:12.372Z
---
**YouTube or Vimeo** blocks embed external videos directly into your documentation. They are useful for tutorials, product walkthroughs, demos, and recorded presentations.
## Syntax
You can add this component using either Markdown or MDX.
::::Tabs
:::Tab{title="Markdown"}
```markdown
:::::Embed{url="https://www.youtube.com/watch?v=VIDEO_ID"}
:::::
```
:::
:::Tab{title="MDX"}
```javascript
```
:::
::::
The `url` property accepts supported YouTube and Vimeo video links.
## MDX example
The following example embeds a YouTube video into a document.
```javascript
```