Markdown 转讲解视频课

要解决什么问题

技术文章写在 Markdown 里很顺手，但做成带旁白、有动效的分集视频课往往要另起一套工具链：分镜、时间轴、配音、渲染分辨率还要和布局像素对齐。本技能把「一篇 .md」当作单一输入，按 ## 标题拆成多集 Remotion Composition，并串起旁白时长、章节过渡与成片合并。

技能如何工作

开工前先确认 分辨率（1080p / 2K / 4K）、旁白性别与 FPS（30 或 60）。分辨率有一条硬规则：Composition 布局始终是 1920×1080，更高清只靠渲染时的 --scale，不要直接把画布改成 4K，否则字号和间距会整体缩小。

典型流水线大致是：

• 分析 Markdown：每章提取概念、例子与章节衔接，输出章节计划
• 搭 Remotion 工程：从技能自带 assets/ 落配置，并实现 OutlinePage（每章开头的目录页）、ChapterAudioLayer（读 voiceover-durations.json 叠旁白，缺了会无声）
• 按章生成 Composition：动画只用 useCurrentFrame() + interpolate() / spring()，常量集中在文件顶部
• 润色叙事：口语化旁白、章间过渡，并建议把源 .md 与视频讲法对齐
• 配音与渲染：用 edge-tts 生成音频、写入时长 JSON，Root.tsx 据此算 durationInFrames；批量渲染后再合并

适用边界与注意点

适合教程、讲义类长文拆课，不适合指望全自动「丢 MD 就出成片」而跳过脚本与动效设计。常见坑包括：COLORS 循环依赖（共享常量应放在 constants.ts）、JSX 里中文弯引号导致 esbuild 报错、以及 voiceover-durations.json 缺章导致音画错位。管线里可配合 environment-setup、remotion-best-practices 等技能做环境与动效规范。