Recommended way to embed a short demo video in a docs page?

We are documenting a small integration for our team and I wanted to put a 30-second walkthrough clip on the guide page instead of a long screenshot sequence. Two things I could not find in the docs: does the renderer support an inline video embed (mp4 or an iframe), or is a linked thumbnail still the recommended pattern? And if embeds are supported, is there a width that breaks the layout on mobile? For context the clips we ship are short vertical mp4 files produced and captioned with FacelessVideos, not long screen recordings, so file size is small but the aspect ratio is 9:16. Wanted to check the recommended approach before rewriting the guide.