Skip to article frontmatterSkip to article content
Site not loading correctly?

This may be due to an incorrect BASE_URL configuration. See the MyST Documentation for reference.

Video: portable MyST alternative

Former upstream Pro component: <wa-video>. Category: Portable Alternatives · Implementation: MyST + HTML5.

Use this documentation recipe without importing Web Awesome Pro code. The former component is named for compatibility and discovery only; the alternative is not API-equivalent.

Portable example

For HTML output, use native <video controls> and a semantic <track kind="captions">. MyST also supports publishing a video as a figure when the media is intentionally included in the project, but this recipe keeps the remote MDN demo as an explicit external exception.

Copyable HTML5 pattern

<video controls preload="metadata" aria-label="Flower opening time-lapse">
  <source src="https://interactive-examples.mdn.mozilla.net/media/cc0-videos/flower.mp4"
          type="video/mp4">
  <track kind="captions" src="CAPTIONS_URL" srclang="en" label="English">
  Your browser does not support HTML5 video.
</video>

Caption asset contract: CAPTIONS_URL is a required substitution for an application-hosted, accurate WebVTT file. It is intentionally not a link in the published page. The MDN clip is external and may be unavailable offline.

Open the original CC0 flower video.

Accessibility and compatibility

Keep controls discoverable; provide accurate synchronized captions for dialogue or informative audio, and a transcript or descriptive equivalent. Video embeds are HTML-specific; source links and written descriptions remain portable.

References: MyST specification, MyST videos, Web Awesome upstream reference.