RevealJS演示文稿分享时嵌入PDF失效问题求助

核心问题分析 #

本地运行正常是因为PDF文件与HTML演示文稿处于同一本地目录，相对路径能被正确解析；但分享（如邮件发送）时，接收方没有对应的本地PDF文件，且默认embed-resources: true配置不会自动将PDF转为Base64嵌入HTML，导致链接和嵌入内容失效。

具体解决步骤 #

1. 将PDF转为Base64编码直接嵌入 #

把PDF内容转为Base64字符串，用原生HTML标签嵌入，让PDF内容直接包含在HTML文件中，无需外部依赖：

• 先将目标PDF转为Base64编码（可通过本地工具生成，注意大文件会大幅增加HTML体积）
• 在Quarto文档中使用如下代码嵌入：

<embed src="data:application/pdf;base64,{你的Base64编码字符串}" width="100%" height="600px" type="application/pdf">

2. 配置Quarto打包资源 #

修改_quarto.yml，启用资源嵌入并指定PDF文件，确保分享时PDF与HTML同步：

format:
  revealjs:
    embed-resources: true
    resource-files:
      - "*.pdf"

注：这种方式需要将生成的HTML和PDF文件一起打包分享，确保两者相对路径不变。

3. 用include指令嵌入Base64内容 #

将PDF的Base64编码保存为文本文件，再通过Quarto的include指令嵌入：

• 把Base64编码保存为pdf-base64.txt
• 在Quarto文档中引用：

---
title: 演示文稿
format: revealjs
---

## 嵌入PDF

```{=html}
<embed src="data:application/pdf;base64,{{< include pdf-base64.txt >}}" width="100%" height="600px">

### 4. 注意事项
- 大体积PDF转Base64后会显著增加HTML文件大小，建议先压缩PDF再处理
- 若选择打包文件的方式，分享时务必保证HTML和PDF的相对路径与本地生成时一致

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