| name | embed |
| description | Embed an external URL (iframe, video, CodePen, etc.) with optional caption, aspect ratio, dimensions, and fullscreen control. Use for live demos and third-party content that won't fit inline. |
Embed
Embeds external content inside an iframe. Aspect ratio, dimensions, and
fullscreen behaviour are all configurable.
Syntax
[!embed](https://example.com/widget)
[!embed aspect="16:9"](https://www.youtube.com/embed/VIDEO_ID)
[!embed aspect="4:3"](https://example.com)
[!embed height="120"](https://example.com)
[!embed width="300" height="600"](https://example.com)
[!embed allowFullScreen="false"](https://example.com)
[!embed el="iframe"](https://example.com)
[!embed text="Live demo"](https://example.com)
Attributes
| Attribute | Notes |
|---|
aspect | 16:9, 4:3, 1:1, … |
width | CSS width or px number. |
height | CSS height or px number. |
allowFullScreen | true (default) or false. |
el | Element type — defaults to iframe. |
text | Optional caption rendered below the frame. |
The URL goes in the parenthesised () part, just like a link.
Examples
[!embed aspect="16:9" text="Product walkthrough"](https://www.youtube.com/embed/dQw4w9WgXcQ)
[!embed aspect="1:1"](https://example.com/widget)
Tips
- Prefer the dedicated
youtube component for YouTube
links — it auto-detects the URL.
- For PDFs, use a regular image link:
.
- If the embedded site sends
X-Frame-Options: DENY, no embed library can
override that — link to the page instead.
