Docs

Video embeds

A video embed places a playable player in the document. Two providers are supported: YouTube and Vimeo.

Syntax

The explicit form names the provider and takes a URL or a bare video id:

@[youtube](https://www.youtube.com/watch?v=dQw4w9WgXcQ)
@[youtube](dQw4w9WgXcQ)
@[vimeo](https://vimeo.com/76979871)

Two shorthand forms also become embeds when the URL belongs to a supported provider:

![Lecture recording](https://www.youtube.com/watch?v=dQw4w9WgXcQ)
[youtube](https://youtu.be/dQw4w9WgXcQ)

– image syntax with a video URL (the alt text becomes the player's accessible title), or a link whose text is exactly the provider name.

All the usual URL shapes are recognized: watch?v=, youtu.be/, youtube.com/embed/, vimeo.com/<id>, with extra query parameters tolerated.

Behavior

  • The player renders responsive, at 16
    , sized to the text column.
  • YouTube embeds use the youtube-nocookie.com privacy-enhanced mode.
  • An unrecognized provider name or an invalid URL renders as the literal text – nothing embeds silently wrong.
  • These are the only two hosts that can appear in an embedded frame; raw <iframe> HTML pointing anywhere else is stripped during sanitization.

Videos are supplements on LibreTimes, not the content itself – a recorded lecture accompanying the written one, a visualization the text discusses. The document should stand without the player.