youtube shortcode

youtube는 YouTube 영상을 본문에 임베드하는 shortcode입니다.
가장 익숙한 외부 영상 임베드 중 하나이며, 튜토리얼, 발표 자료, 쇼케이스 페이지에서 자주 쓰입니다.

공식 문서는 id, allowFullScreen, autoplay, class, controls, end, loading, loop, mute, start, title을 설명합니다. autoplay가 켜지면 mute도 강제로 true가 됩니다. citeturn791175view4turn241043view3

렌더링 결과

원형

{{< youtube 0RKpf3rK57I >}}

해석 포인트

• id만 넣어도 가장 흔한 사용 방식은 충분합니다.
• start와 end를 같이 쓰면 특정 구간만 보여 줄 수 있습니다.
• loop=true는 반복 재생이 필요할 때 유용합니다.
• controls=false는 영상을 보여 주되 조작부를 감추고 싶을 때 사용합니다.

실무 팁

• 문서 상단의 대표 영상보다는, 맥락 설명 뒤의 보조 영상으로 두면 읽기 흐름이 좋습니다.
• 영상 제목, 캡션, 한 줄 요약을 같이 넣으면 임베드만 있을 때보다 훨씬 친절합니다.