用途:md2video-audio 用于把 Markdown 教程、报告或演示文稿转成带旁白的 MP4 视频,生成同步的幻灯画面与语音解说,适合 Markdown 转视频、旁白幻灯片或音视频生成需求。原文件保持不变,另外产出演示、解说和视频三类结果。
主要能力与流程:先检查本地依赖,未经用户确认不安装、删除或修改依赖;在保留原文件的前提下新建一份分段更清晰、过渡更自然的 Markdown;再转为 Marp 兼容幻灯片,用 --- 分隔,防止内容溢出,必要时拆分过大的表格、代码块或章节;随后生成与幻灯片一一对应的解说 Markdown,去掉不应朗读的纯视觉字符并保持分隔同步;最后运行 python ai-2md2marp2av.py presentation.md narration.md,脚本负责渲染 Marp 幻灯片、用 Edge-TTS 生成语音并合成为 MP4。交互输入需用户完成。
回退:主流程失败时依次尝试 python md2marp2av.py,再试 python md2video.py。
适用场景:教程、工作汇报、演示型视频等幻灯片风格内容。
限制:依赖脚本所需的本地运行时与依赖;复杂排版可能需手动调整;Edge-TTS 可用性取决于本地网络与运行环境;缺少文件、权限或用户选择时应停止并询问。建议在本地或授权环境运行,安装依赖或改动环境前需用户确认,生成内容写入新文件而非覆盖源文件,未获明确确认不执行交互或破坏性命令。常见问题包括演示与解说页数不一致(核对 --- 数量)、幻灯片溢出(拆分内容)、依赖缺失导致生成失败(先检查环境再用回退脚本)。