Embed Videos

Add YouTube, Vimeo, and local video files to your documentation pages.

Great Docs supports embedding YouTube, Vimeo, Loom, and local video files with responsive layouts and automatic lazy loading.

Quick Example

To embed a YouTube video, use the following syntax in any .qmd page:

{{< video https://www.youtube.com/watch?v=wo9vZccmqwc >}}

Here’s a live example:

The video is responsive by default, and YouTube embeds use a lightweight thumbnail placeholder that loads the player only when clicked.

Local Video Files

For short screen recordings, reference a local .mp4 file:

{{< video assets/demo.mp4 >}}

Note

Keep video files small. Git repositories aren’t ideal for large binary files. For longer recordings, consider uploading to YouTube or Vimeo and embedding from there.

More Options

For full details on aspect ratios, start times, accessibility labels, Vimeo, Loom, cross-referencing, and performance tips, see the Videos page in the User Guide.