GitHub热榜 pdf2video:让 PDF 动起来的神器,一行代码生成“苹果风”演示视频!

在这个短视频统治注意力的时代，你是否还在此时费力地转发几十页的 PDF 报告，却发现根本没人点开看？如果能把枯燥的技术文档瞬间变成自带运镜、配乐和打字机特效的炫酷视频，会是怎样的体验？今天介绍的这款开源工具，不仅能帮你实现“文档视频化”，甚至还能配合 Claude Code 实现全自动生成，让你的内容传播效率提升 10 倍！

1. 文档写得再好，没人看也是徒劳

作为开发者或内容创作者，我们经常面临一个尴尬的困境：花费数周写好的技术白皮书、研究报告或产品手册，以 PDF 形式发出去后，阅读量寥寥无几。

为什么？因为“太干”了。

现代用户的注意力碎片化，没人愿意在手机上盯着密密麻麻的文字看。你想做个视频介绍一下？打开 PR (Premiere) 或 AE (After Effects) 光是调整关键帧、对齐字幕、找背景音乐，就要花掉你一整天的时间。

我们需要一种**“降维打击”**的工具：它能像处理代码一样处理视频，自动提取 PDF 的精华，用极其炫酷的动效展示出来。

2. pdf2video —— 用代码构建的“虚拟演播室”

pdf2video 正是为此而生。它是一个基于 Remotion（一个允许你用 React 写视频的框架）构建的开源项目。

它的核心逻辑非常极客：你只需要把 PDF 文件扔进去，配置一个简单的 JSON 脚本，它就能自动生成一个 1080P 的高清视频。

在这个视频里，你的 PDF 页面不再是死板的图片，而是变成了可以被“拿捏”的卡片。它支持卡片堆叠、扇形展开、平滑缩放等多种高级运镜，甚至还会自动根据你的脚本计算视频时长，并自动淡入淡出背景音乐。

更炸裂的是，它还内置了 Claude Code Skill。这意味着你甚至不需要自己写配置，直接告诉 Claude：“帮我把这个 PDF 转成视频”，AI 就会自动阅读文档、提取重点、生成脚本并渲染视频。

3. 核心功能与优势详述

🎬 1. 电影级的运镜系统 (Smart Animations)
pdf2video 并不是简单的 PPT 幻灯片切换，它内置了多种高级场景模式，让视频看起来非常有“科技感”：

• • Stack (卡片堆叠): 像洗牌一样展示文档封面，带有自然的入场动画。
• • Focus (焦点缩放): 自动提取页面并放大 2 倍高清渲染，配合呼吸灯效果（Breathing effect），模拟人眼阅读时的聚焦感。
• • Fan (扇形展开): 像展开一把扇子或轮盘一样展示多个页面，视觉冲击力极强。
• • Switch (丝滑切换): 页面之间的过渡带有回弹（Bounce）效果，极其顺滑。

🎹 2. 自动化的视听包装 (Auto-Polish)
一个好的视频离不开细节的打磨。pdf2video 在这方面做得非常细致：

• • 智能字幕: 底部的信息栏支持“打字机特效”（Typing effect），逐字显示页面描述，沉浸感拉满。
• • 动态时长: 你不需要手动拖拽时间轴。在配置文件里写上 duration: 60（帧数），视频长度自动适配，背景音乐也会随之自动调整和淡出。
• • 进度指示: 自动生成“1/5”这样的页码进度条，缓解观众的等待焦虑。

🤖 3. Claude Code 的完美搭档 (AI Agent)
这可能是该项目最大的亮点。作者提供了一个 .claude/skills 插件。
安装后，它就成了 Claude 的“眼睛”和“手”。Claude 可以读取 PDF 内容，理解上下文，然后自动帮你写好 props.json 配置文件。

• • 场景: 你扔给它一份复杂的财报 PDF，说“生成一个 30 秒的视频介绍核心利润数据”，Claude 会自动挑选第 5、8、12 页，并为每一页写好解说词，直接生成视频。

4. 快速上手指南

要使用 pdf2video，你需要本地安装 Node.js 环境。

第一步：克隆项目与安装依赖

git clone https://github.com/YourRepo/pdf2video.git # [此处需替换为真实仓库地址]
cd pdf2video
npm install

第二步：准备素材

将你的 PDF 文件（例如 my-report.pdf）和背景音乐（可选，music.mp3）放入项目的 public/ 文件夹中。

第三步：配置视频脚本

在 props/ 目录下创建一个 my-video.json 文件。这是控制视频的核心：

{
  "src": "/my-report.pdf",
  "title": "2024 年度技术报告",
  "subtitle": "核心架构解析",
  "script": [
    { "type": "stack", "duration": 60 },            // 开场：卡片堆叠效果
    { "type": "focus", "page": 1, "duration": 120 },  // 聚焦第1页，持续4秒
    { "type": "fan", "page": 3, "duration": 150 },    // 第3页使用扇形展开特效
    { "type": "switch", "page": 5, "duration": 120 }  // 切换到第5页
  ],
  "pageDescriptions": {
    "1": "这是项目的整体架构图...",
    "3": "核心模块的详细拆解...",
    "5": "最终的性能测试数据..."
  }
}

第四步：预览与渲染

你可以实时预览效果，调整满意后再生成 MP4 文件。

# 启动本地预览服务器（推荐）
npm run dev

# 渲染最终视频
# 格式: npx remotion render <组件名> <输出路径> --props=<配置文件>
npx remotion render PdfShowcase out/final_video.mp4 --props=./props/my-video.json

渲染完成后，你会得到一个 1920×1080 的高清 MP4 视频，可以直接发到 B 站或视频号！

5. 资源链接与总结

pdf2video 展示了“代码+AI+内容”的无限可能。它不需要你懂复杂的视频剪辑软件，只要你会写几行 JSON，或者会用 AI 对话，就能生产出质量极高的演示视频。对于经常需要做 Technical Sharing 的开发者来说，这绝对是提升逼格的神器。

🔗 项目开源地址：
GitHub: https://github.com/DangJin/pdf2video

快去下载体验一下，把那些压箱底的 PDF 变成酷炫的视频吧！别忘了给作者点个 Star 🌟！