一、核心目标使用微软官方 MarkItDown 工具将.mp4视频文件转换为 Markdown 格式的会议文字纪要。二、前置依赖与安装步骤1. 关键前提Python 版本要求MarkItDown 官方要求Python ≥ 3.10Python 3.8 及以下版本会直接报错。本次使用Python 3.12版本安装时必须勾选「Add Python.exe to PATH」。2. MarkItDown 官方包安装离线方式访问微软官方仓库点击「Code → Download ZIP」下载源码包。解压后将packages/markitdown文件夹复制到D:\markitdown。用 Python 3.12 执行离线安装py -3.12 -m pip install D:\markitdown -i https://pypi.tuna.tsinghua.edu.cn/simple安装全功能依赖支持视频 / 音频 / Office 文档py -3.12 -m pip install markitdown[all] -i https://pypi.tuna.tsinghua.edu.cn/simple3. 必装工具FFmpeg视频 / 音频处理依赖报错提示Couldnt find ffmpeg or avconv→ 必须安装 FFmpeg 才能解析视频文件。安装步骤下载地址Download FFmpeg下载ffmpeg-release-full_build-www.gyan.dev.7z解压后进入bin文件夹。将ffmpeg.exe、ffprobe.exe复制到D:\python312\Scripts目录。验证安装ffmpeg -version三、视频转文字操作指南1. 路径格式注意事项避免手动输入路径推荐选中文件 → Shift 右键 →「复制为路径」直接粘贴到命令中。路径中不能有中文引号 必须使用英文双引号包裹完整路径。2. 单文件转换命令py -3.12 -m markitdown 你的视频文件路径.mp4 -o 输出文件夹\输出文件名.md示例本次使用py -3.12 -m markitdown C:\Users\admin\Desktop\2021-09-08 18.24.35 850371713\meeting_01.mp4 -o C:\Users\admin\Desktop\output\meeting_01.md3. 批量转换文件夹内所有 MP4cd 视频文件夹路径 dir *.mp4 | ForEach-Object { py -3.12 -m markitdown $_.FullName -o C:\Users\admin\Desktop\output\$($_.BaseName).md }四、常见问题与解决方案问题现象根因解决方案ERROR: markitdown requires Python 3.10Python 版本过低3.8安装 Python 3.12用py -3.12强制调用新版FileNotFoundError: 系统找不到指定的文件路径错误 / 包含特殊符号用 Shift右键 复制路径删除中文引号生成的.md文件为空缺少 FFmpeg无法解析视频音频安装 FFmpeg 并复制到 Python 的 Scripts 目录markitdown: error: unrecognized arguments路径未被完整包裹用英文双引号完整包裹文件路径网络代理 / 镜像源下载失败国内网络限制使用清华源-i https://pypi.tuna.tsinghua.edu.cn/simple或离线安装五、最终验证安装验证py -3.12 -m markitdown --version正常输出0.1.6b2或更高版本号。转换验证运行转换命令后打开输出的.md文件确认视频语音已成功转写为文字内容。六、补充说明MarkItDown 对视频的语音转文字功能目前处于测试阶段依赖 Whisper 模型需确保网络通畅。