如何在GitHub的Jupyter Notebook中嵌入PDF文件

嘿，我太懂你这个困扰了——本地Jupyter Notebook里好好的内嵌PDF，一上传到GitHub就没影了对吧？这其实是GitHub对Notebook渲染的安全限制和路径解析规则在搞鬼，我给你几个实用的解决办法，亲测有效：

如果你的PDF页数不多，这个方法最省心，完全不用担心GitHub的限制：

• 用工具把PDF的每一页转换成PNG/JPG格式（比如用Adobe Acrobat的导出功能，或者写个简单的Python脚本用pdf2image库批量转换）
• 在Notebook里用Markdown图片语法依次插入每一页：

  ![PDF第1页](page1.png)
  ![PDF第2页](page2.png)
  

• 把转换好的图片和Notebook、原PDF一起上传到GitHub，这样打开Notebook时就能直接看到PDF的内容了，和本地显示效果几乎一致

如果需要保留PDF的缩放、跳转等交互功能，可以用GitHub Pages来托管：

1. 打开你的GitHub仓库，进入「Settings」→「Pages」，设置部署分支为你的默认分支（比如main），目录选对应路径，保存后等几分钟让Pages部署完成
2. 在Notebook里插入HTML代码块，用Pages的绝对路径指向PDF：

   <iframe src="/你的仓库名/同目录路径/你的文件.pdf" width="100%" height="600px"></iframe>
   

3. 上传Notebook后，不要直接在GitHub仓库里看，访问GitHub Pages提供的Notebook链接，就能看到内嵌的可交互PDF了

这个方法不用折腾Pages，直接在GitHub的Notebook里就能显示内嵌PDF：

1. 在GitHub仓库里找到你的PDF文件，点击右上角的「Raw」按钮，复制弹出页面的URL（这是PDF的原始文件地址）
2. 在Notebook里插入HTML代码块，把Raw地址填进去：

   <iframe src="https://docs.google.com/gview?url=你的PDF Raw地址&embedded=true" width="100%" height="600px"></iframe>
   

3. 保存并上传Notebook，现在在GitHub里打开Notebook就能看到内嵌的PDF预览了——原理是借助Google Docs的预览服务绕开GitHub的限制，亲测稳定

本地的Jupyter服务器是直接从你的电脑文件系统加载资源，没有跨域限制，相对路径也能直接解析；但GitHub的Notebook渲染是在他们的平台上处理，为了安全限制了本地资源的直接加载，而且相对路径的解析规则和本地完全不同，所以直接用本地的嵌入方法就失效了。

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