記法ガイドに埋め込み（YouTube・X・Speakerdeck）を足す

[ma91n]

3つとも記事で実際に使われている（X 47記事・Speakerdeck 70記事・YouTube 23記事）のに、貼り方がどこにも書いていなかった。書き手向けの決まりを記法ガイドに足す。

足したこと

## 埋め込み を新設し、### YouTube / ### X / ### Speakerdeck を置いた。共通の決まりは2つ。

• 提供元のコードをそのまま貼る。 Markdown の中に HTML を直接書ける
• 幅と高さを書き換えない。 狭い画面での収まりは CSS（スライド埋め込みがモバイルで縦に空きすぎる #2454）が持つので、width="560" height="315" が付いたままでよい。書き換えると二重に効く

サービスごとの注意:

	書くこと
YouTube	「共有」→「埋め込む」のコード。title を残す（読み上げでは動画の名前になる）。Google スライドと SlideShare も同じ扱い
X	<blockquote class="twitter-tweet"> と widgets.js の2点セット。ポストが消えると埋め込みも消えるので要点は本文にも書く（blockquote の中だけが残る）
Speakerdeck	「Embed」のコード。<script> 形式と <iframe> 形式のどちらでも出るが、選べるなら <iframe> 形式（外部の JS を読まずに済む）。style を消さない（幅と縦横比を自分で持っている）

実物は出していない

他の節は表示結果を並べていますが、ここは貼り方だけにしました。中身は提供元のプレイヤーで、このブログの見た目の決まりが効く範囲の外にあります。実物を置くと、記法ガイドを開くだけで3つの外部サービスへの接続が走ります（X と Speakerdeck の <script> 形式は外部 JS の読み込みつき）。その理由もページに1行書いてあります。

CLAUDE.md にも同じ決まりを足しました（CSS が幅を合わせる対象は YouTube / Google スライド / SlideShare で、Speakerdeck は触らない、まで）。

確認

• /specials/markdown/ の末尾 … 「埋め込み」の3節、コードブロックが html で色が付くこと、生きた埋め込みが混ざっていないこと、サイドバーの目次に3節が出ること

🤖 Generated with Claude Code