External Media Embeds

SevenMark supports embedding external media from popular platforms using the [[#provider ...]] syntax.

Supported Platforms

Platform	Syntax	Description
YouTube	[[#youtube ...]]	Video and playlist embeds
Vimeo	[[#vimeo ...]]	Video embeds
NicoNico	[[#nicovideo ...]]	Japanese video platform
Spotify	[[#spotify ...]]	Music and podcast embeds
Discord	[[#discord ...]]	Server widget embeds

---

YouTube

Embed YouTube videos and playlists.

Basic Video

[[#youtube #id="dQw4w9WgXcQ"]]

Playlist

[[#youtube #playlist="PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf"]]

Video from Playlist

[[#youtube #id="dQw4w9WgXcQ" #playlist="PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf"]]

Parameters

Parameter	Description	Default
#id	Video ID (required if no playlist)	-
#playlist	Playlist ID	-
#width	Player width	640
#height	Player height	360
#start	Start time in seconds	-
#end	End time in seconds	-
#autoplay	Auto-play on load (presence = enabled)	-
#loop	Loop video (presence = enabled)	-
#mute	Start muted (presence = enabled)	-
#nocontrols	Hide player controls (presence = enabled)	-

Examples

// Custom dimensions
[[#youtube #id="dQw4w9WgXcQ" #width="800" #height="450"]]

// Start at 30 seconds, end at 60 seconds
[[#youtube #id="dQw4w9WgXcQ" #start="30" #end="60"]]

// Autoplay, muted, looping
[[#youtube #id="dQw4w9WgXcQ" #autoplay #mute #loop]]

// No controls (clean embed)
[[#youtube #id="dQw4w9WgXcQ" #nocontrols]]

---

Vimeo

Embed Vimeo videos.

Basic Video

[[#vimeo #id="76979871"]]

Parameters

Parameter	Description	Default
#id	Video ID (required)	-
#h	Hash for unlisted videos	-
#width	Player width	640
#height	Player height	360
#autoplay	Auto-play on load	-
#loop	Loop video	-
#mute	Start muted	-
#color	Player accent color (hex without #)	-
#dnt	Do Not Track mode	-

Examples

// Basic embed
[[#vimeo #id="76979871"]]

// Unlisted video with hash
[[#vimeo #id="76979871" #h="abc123def"]]

// Custom color accent
[[#vimeo #id="76979871" #color="ff0000"]]

// Privacy-focused embed
[[#vimeo #id="76979871" #dnt]]

---

NicoNico (nicovideo)

Embed videos from NicoNico Douga (Japanese video platform).

Basic Video

[[#nicovideo #id="sm9"]]

Parameters

Parameter	Description	Default
#id	Video ID (required, e.g., "sm9", "so39402840")	-
#width	Player width	640
#height	Player height	360
#from	Start time in seconds	-
#autoplay	Auto-play on load	-

Examples

// Classic video
[[#nicovideo #id="sm9"]]

// Start at specific time
[[#nicovideo #id="sm9" #from="60"]]

// Custom size with autoplay
[[#nicovideo #id="sm9" #width="800" #height="450" #autoplay]]

---

Spotify

Embed Spotify tracks, albums, playlists, artists, podcasts, and episodes.

Track

[[#spotify #track="4uLU6hMCjMI75M1A2tKUQC"]]

Album

[[#spotify #album="4aawyAB9vmqN3uQ7FjRGTy"]]

Playlist

[[#spotify #playlist="37i9dQZF1DXcBWIGoYBM5M"]]

Artist

[[#spotify #artist="0OdUWJ0sBjDrqHygGUXeCF"]]

Podcast Episode

[[#spotify #episode="512ojhOuo1ktJprKbVcKyQ"]]

Podcast Show

[[#spotify #show="2mTUnDkuKUkhiueKcVWoP0"]]

Parameters

Parameter	Description	Default
#track	Track ID	-
#album	Album ID	-
#playlist	Playlist ID	-
#artist	Artist ID	-
#episode	Podcast episode ID	-
#show	Podcast show ID	-
#width	Player width	100%
#height	Player height	352
#dark	Dark theme (presence = enabled)	-
#compact	Compact cover art view (presence = enabled)	-

Note: One of #track, #album, #playlist, #artist, #episode, or #show is required.

Examples

// Dark theme
[[#spotify #track="4uLU6hMCjMI75M1A2tKUQC" #dark]]

// Compact view
[[#spotify #track="4uLU6hMCjMI75M1A2tKUQC" #compact]]

// Custom dimensions
[[#spotify #playlist="37i9dQZF1DXcBWIGoYBM5M" #width="300" #height="380"]]

---

Discord

Embed Discord server widgets.

Basic Widget

[[#discord #id="123456789012345678"]]

Parameters

Parameter	Description	Default
#id	Server ID (required)	-
#width	Widget width	350
#height	Widget height	500
#dark	Dark theme (presence = enabled)	light

Examples

// Light theme (default)
[[#discord #id="123456789012345678"]]

// Dark theme
[[#discord #id="123456789012345678" #dark]]

// Custom dimensions
[[#discord #id="123456789012345678" #width="400" #height="600" #dark]]

---

External Media in Complex Structures

In Lists

{{{#list #1
[[Video Tutorial:]]
[[[[#youtube #id="dQw4w9WgXcQ"]]]]
[[Music:]]
[[[[#spotify #track="4uLU6hMCjMI75M1A2tKUQC"]]]]
}}}

In Fold Elements

{{{#fold
[[Watch Video]]
[[
[[#youtube #id="dQw4w9WgXcQ" #width="560" #height="315"]]
]]
}}}

Multiple Embeds

# Media Gallery

## Videos

[[#youtube #id="dQw4w9WgXcQ"]]

[[#vimeo #id="76979871"]]

## Music

[[#spotify #album="4aawyAB9vmqN3uQ7FjRGTy"]]

## Community

[[#discord #id="123456789012345678" #dark]]

---

Best Practices

Responsive Embeds

For responsive layouts, use percentage widths:

[[#youtube #id="dQw4w9WgXcQ" #width="100%"]]

Privacy Considerations

Use privacy-enhancing options when available:

// Vimeo Do Not Track
[[#vimeo #id="76979871" #dnt]]

// YouTube without autoplay
[[#youtube #id="dQw4w9WgXcQ"]]

Accessibility

Always provide context around embedded media:

Watch the introduction video below:

[[#youtube #id="dQw4w9WgXcQ"]]

*Video: Introduction to SevenMark (5 minutes)*

Technical Notes

• External media elements use the [[#provider ...]] syntax (double brackets)
• All parameters use the #key="value" format
• Boolean parameters (like #autoplay, #mute, #dark) are enabled by their presence
• Missing required parameters will result in an error message being displayed
• Embeds are rendered as iframes with lazy loading enabled
• Each platform has specific CSS classes for styling customization