Videos
Incrusta videos de YouTube, Vimeo, Loom y Wistia, o reproduce archivos de video de tu repositorio.
Actualizado el 19 nov 20262 min de lectura
Usa <Video> con el enlace a un video. Pega la dirección que compartirías: Typemark la convierte en el reproductor.
<Video src="https://www.youtube.com/watch?v=aqz-KE-bpKQ" title="Big Buck Bunny" />
Los reproductores ocupan el ancho de la página con una proporción de 16:9 y solo se cargan cuando el lector llega a ellos al desplazarse.
Reproductores compatibles
| Servicio | Enlaces que puedes usar |
|---|---|
| YouTube | youtube.com/watch?v=…, youtu.be/…, youtube.com/shorts/…, youtube.com/embed/… |
| Vimeo | vimeo.com/…, player.vimeo.com/video/… |
| Loom | loom.com/share/…, loom.com/embed/… |
| Wistia | fast.wistia.net/embed/iframe/…, <account>.wistia.com/medias/… |
Los videos de YouTube se reproducen desde youtube-nocookie.com, el modo de mayor privacidad de YouTube. Se conserva el tiempo de inicio que incluya el enlace (?t=90 o ?t=1m30s).
Un enlace a cualquier otro sitio no se incrusta: los lectores ven en su lugar un enlace a él.
Archivos de video
Apunta src a un video de tu repositorio o a un archivo de video en la web. Los archivos MP4, WebM, MOV y M4V se reproducen con los controles del navegador.
<Video src="/videos/setup.mp4" />
Añade autoPlay para un clip corto que se reproduce en silencio y en bucle, como un GIF:
<Video src="/videos/drag-and-drop.mp4" autoPlay />
Las rutas como /videos/setup.mp4 funcionan igual que las rutas de imágenes.
Subtítulos
caption añade un marco con un pie de foto debajo del video.
<Video src="https://vimeo.com/76979871" caption="The Typemark editor in two minutes" />
Propiedades
| Propiedad | Tipo | Valor predeterminado | Descripción |
|---|---|---|---|
src | string | obligatorio | Un enlace de YouTube, Vimeo, Loom o Wistia, o un archivo de video. |
title | string | el nombre del servicio | Describe el reproductor para los lectores de pantalla. |
caption | string | ninguno | Texto debajo del video, dentro de un marco. |
autoPlay | boolean | false | Para archivos de video: se reproduce silenciado, en bucle y sin controles. |
Incrustaciones HTML
Las páginas importadas de otras plataformas de documentación suelen incrustar videos con etiquetas <iframe> y <video>, dentro de un Frame. Estas funcionan tal cual:
<Frame>
<iframe
src="https://www.youtube.com/embed/aqz-KE-bpKQ"
title="YouTube video player"
allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
allowFullScreen
></iframe>
</Frame>
<video autoPlay muted loop playsInline src="/videos/demo.mp4"></video>
Por seguridad, un <iframe> solo incrusta los reproductores listados arriba, con sandbox y con la configuración de Typemark en lugar de los atributos de la etiqueta. Un <iframe> que apunte a cualquier otro lugar se convierte en un enlace a esa página.
En el editor visual
Escribe /video, pega el enlace y pulsa Enter. El bloque reproduce el video en el editor; Change link lo reemplaza. Pulsa Escape en un bloque vacío para eliminarlo. Las etiquetas <iframe> y <video> se muestran como código fuente y se guardan exactamente como se escribieron.