Typemark Documentation

動画

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 の比率で表示され、読者がスクロールしてそこに到達したときにのみ読み込まれます。

対応しているプレイヤー

サービス使用できるリンク
YouTubeyoutube.com/watch?v=…、youtu.be/…、youtube.com/shorts/…、youtube.com/embed/…
Vimeovimeo.com/…、player.vimeo.com/video/…
Loomloom.com/share/…、loom.com/embed/…
Wistiafast.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" />

プロパティ

プロパティ型デフォルト説明
srcstring必須YouTube、Vimeo、Loom、Wistia のリンク、または動画ファイル。
titlestringサービス名スクリーンリーダー向けにプレイヤーを説明します。
captionstringなしフレーム内で動画の下に表示されるテキスト。
autoPlaybooleanfalse動画ファイル用:ミュートでループ再生し、コントロールを表示しません。

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> タグはソースとして表示され、書いたとおりのまま保存されます。