動画
YouTube、Vimeo、Loom、Wistia の動画を埋め込んだり、リポジトリ内の動画ファイルを再生したりできます。
2026年11月19日更新
動画へのリンクを使うには <Video> を使います。共有したいアドレスをそのまま貼り付けてください。Typemark がプレイヤーに変換します。
<Video src="https://www.youtube.com/watch?v=aqz-KE-bpKQ" title="Big Buck Bunny" />
プレイヤーはページの幅いっぱいに 16:9 の比率で表示され、読者がスクロールしてそこに到達したときにのみ読み込まれます。
対応しているプレイヤー
| サービス | 使用できるリンク |
|---|---|
| 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/… |
YouTube の動画は、YouTube のプライバシー強化モードである youtube-nocookie.com から再生されます。リンクに含まれる開始時刻(?t=90 や ?t=1m30s)は保持されます。
その他のサイトへのリンクは埋め込まれません。代わりに、読者にはそのサイトへのリンクが表示されます。
動画ファイル
src にリポジトリ内の動画、またはウェブ上の動画ファイルを指定します。MP4、WebM、MOV、M4V ファイルはブラウザの再生コントロール付きで再生されます。
<Video src="/videos/setup.mp4" />
GIF のように、音声なしでループ再生される短いクリップには autoPlay を追加します。
<Video src="/videos/drag-and-drop.mp4" autoPlay />
/videos/setup.mp4 のようなパスは、画像のパスと同じように機能します。
キャプション
caption を指定すると、動画の下にキャプション付きのフレームが追加されます。
<Video src="https://vimeo.com/76979871" caption="The Typemark editor in two minutes" />
プロパティ
| プロパティ | 型 | デフォルト | 説明 |
|---|---|---|---|
src | string | 必須 | YouTube、Vimeo、Loom、Wistia のリンク、または動画ファイル。 |
title | string | サービス名 | スクリーンリーダー向けにプレイヤーを説明します。 |
caption | string | なし | フレーム内で動画の下に表示されるテキスト。 |
autoPlay | boolean | false | 動画ファイル用:ミュートでループ再生し、コントロールを表示しません。 |
HTML の埋め込み
他のドキュメントプラットフォームからインポートされたページでは、Frame の中に <iframe> や <video> タグで動画が埋め込まれていることがよくあります。これらはそのまま動作します。
<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>
セキュリティのため、<iframe> は上記のプレイヤーのみを埋め込み、サンドボックス化されます。タグ上の属性は Typemark 独自の設定に置き換えられます。それ以外のページを指す <iframe> は、そのページへのリンクに変換されます。
ビジュアルエディタでの操作
/video と入力し、リンクを貼り付けて Enter を押します。ブロックはエディタ内で動画を再生します。Change link を押すと動画を差し替えられます。空のブロックで Escape を押すと削除されます。<iframe> と <video> タグはソースとして表示され、書いたとおりのまま保存されます。