如何在bookdown的HTML输出中嵌入YouTube视频？

问题原因 #

直接使用![](https://youtu.be/jg91ikK0OCI)是Markdown的图片插入语法，LaTeX会将其识别为图片文件路径从而报错；即使仅生成HTML，该语法也无法将YouTube链接转为可播放的视频嵌入，只会显示链接占位。

解决方案 #

1. 直接使用HTML iframe标签（最简便）

Bookdown支持原生HTML，直接用YouTube官方的嵌入代码即可，注意把短链接转换为embed格式：

<iframe width="560" height="315" src="https://www.youtube.com/embed/jg91ikK0OCI" title="YouTube视频播放器" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

• 可自行调整width和height参数控制视频尺寸
• youtu.be/jg91ikK0OCI需替换为youtube.com/embed/jg91ikK0OCI，这是YouTube的嵌入专用路径

2. 使用R代码调用knitr::include_url（更符合RMarkdown规范）

在R代码块中调用该函数，自动生成嵌入代码：

```{r, echo=FALSE}
knitr::include_url("https://www.youtube.com/embed/jg91ikK0OCI", height = "315px", width = "560px")

- `echo=FALSE`用于隐藏代码块，仅显示视频

#### 3. 规范配置`_output.yaml`（无需删除全部内容）
不用清空配置文件，只需保留需要的HTML输出格式，避免触发PDF生成：
```yaml
bookdown::gitbook:
  css: style.css
  config:
    toc:
      before: |
        <li><a href="./">A Minimal Book Example</a></li>
      after: |
        <li><a href="https://github.com/rstudio/bookdown" target="blank">Published with bookdown</a></li>
    edit: https://github.com/rstudio/bookdown-demo/edit/master/%s
    download: ["epub"] # 移除pdf下载选项，避免触发PDF编译
# 注释或删除PDF、EPUB等不需要的输出配置
# bookdown::pdf_book:
#   includes:
#     in_header: preamble.tex
#   latex_engine: xelatex
#   citation_package: natbib
#   keep_tex: yes
# bookdown::epub_book: default
# bookdown::bs4_book: default

内容的提问来源于stack exchange，提问作者alagris