Embeds
Embed external media with a single line. Write embed: followed by a URL — sitemd detects the provider and renders a responsive embed automatically.
No iframes, no HTML, no configuration. Just the URL.
embed: https://media1.tenor.com/m/Nkw4aIUJWcEAAAAC/brent-rambo-thumbs-up.gif
Supported providers
sitemd auto-detects these providers from the URL:
| Provider | Example URL |
|---|---|
| YouTube | youtube.com/watch?v=ID or youtu.be/ID |
| Vimeo | vimeo.com/123456 |
| X / Twitter | x.com/user/status/123 or twitter.com/user/status/123 |
reddit.com/r/sub/comments/ID/title |
|
instagram.com/p/ID or instagram.com/reel/ID |
|
linkedin.com/posts/user-activity-ID or linkedin.com/embed/feed/update/urn:li:share:ID |
|
| TikTok | tiktok.com/@user/video/ID |
| Spotify | open.spotify.com/track/ID, album/ID, playlist/ID, episode/ID |
| CodePen | codepen.io/user/pen/ID |
| Images | Any URL ending in .png, .jpg, .gif, .webp, .avif, or .svg |
Any URL not matching a known provider or image extension renders as a generic iframe. For image resizing, cropping, filters, and galleries, see Images.
Usage
Write embed: on its own line followed by the full URL:
Some text above the video.
embed: https://www.youtube.com/watch?v=dQw4w9WgXcQ
More text below.
Each embed stands alone — unlike buttons, consecutive embeds are not grouped together.
Examples by provider
YouTube
embed: https://www.youtube.com/watch?v=dQw4w9WgXcQ
Spotify
embed: https://open.spotify.com/track/4cOdK2wGLETKBW3PvgPWqT
embed: https://open.spotify.com/album/1DFixLWuPkv3KT3TnV35m3
embed: https://open.spotify.com/playlist/37i9dQZF1DXcBWIGoYBM5M
Vimeo
embed: https://vimeo.com/76979871
X / Twitter
embed: https://x.com/elonmusk/status/1585341984679469056
embed: https://www.reddit.com/r/vibecoding/comments/1qqxshz/has_anyone_vibecoded_something_to_finish_that/
embed: https://www.instagram.com/p/C0xFHGOrBN7/
embed: https://www.linkedin.com/embed/feed/update/urn:li:share:6898694772484112384
TikTok
embed: https://www.tiktok.com/@bellapoarch/video/6862153058223197445
CodePen
embed: https://codepen.io/thebabydino/pen/mOJvyB
Images
embed: https://upload.wikimedia.org/wikipedia/commons/thumb/d/dc/BrownSpiderMonkey_%28edit2%29.jpg/500px-BrownSpiderMonkey_%28edit2%29.jpg
embed: /theme/images/hero.webp
For image resizing, cropping, filters, and galleries, see Images.
Any other URL
embed: https://randompicturegenerator.com
Falls back to a generic responsive iframe.
Notes
- Embeds inside fenced code blocks are displayed as text, not rendered.
- Each embed is wrapped in a responsive container that adapts to the content type — 16:9 for video, compact player for Spotify, taller frame for CodePen.
- For full control over iframe attributes, use inline HTML instead.