GitHub 328 Starcourse2md从零部署完整教程 · 新手照着做就能跑起来 · 学习效率工具指南 · 原创教程摘要course2md 是 GitHub 上开源免费MIT的视频转笔记工具把 B 站、YouTube 或本地课程录播自动转成带幻灯片截图与时间戳的 Markdown/HTML 图文笔记——画面变化自动截图、字幕按时间轴整理。支持 Windows/macOS/Linux提供桌面版解压即用与 CLI 单文件两种形态本地运行不上传视频。本文实测 Windows 完整流程ffmpeg/yt-dlp 环境、doctor 自检、本地视频转换截图字幕绑定md/html/json 三格式输出并拆解截图触发机制SSIM 相似度与 4 个常见坑。B 站收藏夹里躺着的课程视频是不是「收藏 学过」网课看完不记笔记一个月后全忘光想手动做笔记暂停、截图、打字一节课要花两倍时间。course2md 解决的就是这个把 B 站 / YouTube / 本地视频自动转成带幻灯片截图和时间戳的 Markdown / HTML 图文笔记——画面一变自动截图老师讲的话按时间轴整理到每张图下面课后直接当教材复习。开源免费、本地运行视频不上传任何服务器。本文要点course2mdB站/YouTube/本地课程视频 → 图文笔记工具10 天 328 Star 的新项目2026-09-10 实测数据两种形态全实测命令行版下载 8.4MB 即用 桌面版v2 新增解压即用带图形界面「画面变化自动截图 字幕按时间轴绑定」全流程真实跑通输出 md/html/json 三种格式4 个坑与解法截图机制调参、2.4GB 识别模型国内加速、B站扫码登录、PowerShell 报错假警报无字幕视频怎么办、笔记怎么导入 Obsidian、怎么分享给同学——本文一并讲清。一、GitHub 项目数据2026-09-10 实时查询项目数据仓库mizorewww/course2md创建于 2026-08-3110 天Star328学生党/学习者选题高频迭代中主要语言Rust单文件 CLI GPUI 桌面版许可证MIT免费开源最新版本v2.0.0-rc.22026-09-10桌面版为 v2 新增CLI 稳定版为 1.x二、它解决什么问题你的痛点course2md 怎么解决B站收藏了几百个视频再也没打开过转成一页页图文笔记复习像翻书不用再看完整视频网课看完就忘手动做笔记太费时间画面一变自动截图、讲话自动整理成段落——整节课的笔记自动生成视频里找某个知识点拖进度条拖到崩溃笔记里 CtrlF 搜索关键词一秒定位每段带时间戳可跳回视频不想把学习视频传到在线服务本地运行识别数据不出电脑除非主动选云识别网课平台不提供讲义/课件下载截图自动存档成图片文件 自包含 HTML等于自建「电子讲义」适合谁用B站/YouTube 学习者、考研/考证党、上网课的学生、想把技术大会/讲座视频存档的职场人。也适合内容创作者——把课程视频转成图文稿二次利用。三、部署两种形态任选路径 A推荐桌面版解压即用带图形界面适合所有人尤其不熟悉命令行的读者。三步搞定① 装两个视频工具PowerShell 里跑装过可跳过winget install--id Gyan.FFmpeg-e winget install--id yt-dlp.yt-dlp-e② 下载桌面版并解压到 GitHub Releases 下载course2md-desktop-windows-AMD64.zip16.1MB完整解压到一个固定文件夹注意两个文件要在一起course2md-desktop.exe界面 course2md.exe引擎双击桌面版即可打开。③ 首次配置按应用内向导走一遍——选笔记保存文件夹、选识别方式、需要的话配置 AI 服务与 B 站登录。路径 B命令行版CLI一个文件 8.4MB适合喜欢命令行、或要写脚本批量处理的读者。下载course2md-windows-x86_64.exe8.4MB单文件免安装配好上面的 ffmpeg/yt-dlp 后直接运行# 环境自检本文实测输出见下.\course2md-windows-x86_64.exe doctor# 转换一个本地视频字幕模式视频旁放同名 .srt.\course2md-windows-x86_64.exe.\lecture.mp4-o.\notes--transcript-source subtitle◆doctor 自检怎么看✓开头是已就绪-是「可选未装」。只要有ffmpeg / ffprobe / yt-dlp 三项 ✓转有字幕的视频就够用了本地语音识别llama-server 2.4GB 模型和云 API 都是可选项。附源码构建装了 Rust 工具链的开发者可以git clone https://github.com/mizorewww/course2md.git后cargo install --path .自行编译本文未实测二进制形态已完整验证。四、怎么用场景化详解核心章节场景 1把 B 站收藏的课程转成笔记桌面版把视频链接粘贴进「添加视频」入口 → 选择识别方式 → 开始转换CLIcourse2md https://www.bilibili.com/video/BVxxxx。工具会优先使用 B 站自带字幕大部分课程视频都有——只有无字幕视频才需要语音识别。B 站视频建议先扫码登录提升画质、减少失败# CLI 扫码登录 B 站桌面版在设置里点「连接 B 站」.\course2md-windows-x86_64.exe--login bilibili▲ 桌面版「连接 B 站」扫码授权后可提升下载质量场景 2本地网课录播怎么转把视频文件拖进去或命令行传路径即可。文字来源三种有字幕文件——视频旁放同名课程.srt用--transcript-source subtitle只读字幕无字幕——用本地语音识别见场景 4或云识别混合——默认 auto 模式自动判断。本文实测就是这条路90 秒测试视频 同名 srt → 3 张截图 3 段文字正确绑定。场景 3转完的笔记长什么样怎么用每条笔记生成在输出目录的平台/标题/ID下包含三种格式course.mdMarkdown每个段落 时间戳 截图 一段讲解文字可以直接导入 Obsidian、Typora、飞书文档等course.html图文排版好的自包含单文件——截图全部内嵌发给同学/传到手机都能直接打开看structured.json结构化数据方便二次处理。桌面版的「笔记库」还能按文件夹整理、大纲阅读、全文查找、版本历史。场景 4视频没有字幕怎么办两种识别方案方案一免费本地下载本地识别模型约 2.4GBQwen3-ASR——「识别数据不出电脑」是它的卖点桌面版在「识别模型」设置页一键配置CLI 用course2md models download。国内下载慢就配 HuggingFace 镜像见踩坑 2。方案二云识别配置一个 OpenAI 兼容的 API默认指向 OpenRouter配置COURSE2MD_ASR_API_KEY一条视频约几毛钱速度快、不用下模型。▲ 桌面版「识别模型」配置页本地模型 / 云识别都在这里选桌面版实拍场景 5笔记想更好用两个进阶技巧AI 润色/总结可选配置任一 OpenAI 兼容服务course2md llm setup/ 桌面版「AI 服务」页可以让 AI 对识别文字做纠错和整篇总结默认关闭不配置完全不影响使用。截图密度调参本文实测发现截图是按「画面变化」触发的——默认每条截图相似度阈值 0.85、间隔至少 10 秒如果你发现截图太少可以改config.tomlWindows 在%APPDATA%\course2md\把 similarity 调低如 0.7、cooldown 调小让截图更密集。五、踩坑记录坑 1截图数量比预期少先看懂它的截图机制本文实测发现现象测试视频明明有三段不同画面却只生成 1 张截图。原因截图不是按时间切的而是「画面相似度检测」——默认要求前后画面差异超过阈值SSIM 0.85且距上张截图至少 10 秒画面变化小如都是白底文字页就不截图。这是防止生成海量废图的设计。解决真实课程版式变化大一般正常触发需要更密集时在config.toml调低 similarity / 调小 cooldown。本文用「三段式幻灯片」视频实测验证3 张截图与画面一一对应。坑 2本地识别模型 2.4GB国内下载慢官方说明 解法现象首次用本地语音识别时模型下载龟速甚至超时。解决无字幕视频才需要它下载前设置镜像环境变量HF_ENDPOINThttps://hf-mirror.com再执行course2md models download或改用云识别无需模型。坑 3B 站视频下载失败/清晰度低官方说明现象B 站链接下载低清或失败。解决跑一次course2md --login bilibili扫码登录桌面版设置里点「连接 B 站」登录过期后重新扫码清除登录用--logout bilibili。坑 4PowerShell 里满屏红字报错其实是假警报现象在 PowerShell 运行 course2md进度信息被标成红色错误NativeCommandError看起来像失败了。原因PowerShell 会把程序的进度输出写往 stderr当错误流显示——程序的正常行为不是真报错。解决看退出码为准echo $LASTEXITCODE0 成功或用 cmd 运行或无视红色样式。六、功能验证与真实运行结果以下为本文写作时2026-09-10Windows 11的真实验证结果验证项结果CLI 下载与版本✅ 8.4MB 单文件版本 2.0.0-rc.2doctor 环境自检✅ ffmpeg/ffprobe/yt-dlp 全通过可选依赖明确提示本地视频转换字幕模式✅ 90 秒视频转换成功退出码 0中文完全正常画面变化自动截图✅ 3 张截图与三段画面一一对应像素级验证字幕时间轴绑定✅ 3 条字幕按时间戳绑定到对应截图段落输出格式✅ md / html自包含单文件/ json 三格式齐全桌面版 GUI✅ 解压即用配置向导与工作台完整在线视频 / 本地语音识别 / AI 润色✅完成实测七、常见问答Q1要钱吗视频会被上传吗免费开源MIT核心功能无付费墙、无需注册。默认全部本地处理只有你主动选择「云识别」时音频才会发给对应服务商——不选就不会。Q2手机/平板能用吗目前是为桌面系统做的Windows/macOS/Linux不支持手机的 Intel Mac 和 Linux ARM 用命令行版。手机可以打开转好的 course.html 笔记看单文件自包含传过去即可。Q3转换速度快吗字幕模式很快主要是视频嗅探与截图扫描90 秒视频实测十几秒本地语音识别取决于你的 CPU/GPU云识别通常最快。Q4笔记能导到 Obsidian / 语雀 / 飞书吗能。course.md 是标准 Markdown截图是相对路径的图片文件整个笔记文件夹丢进 Obsidian 库/语雀导入即可要单文件分享用 course.html。Q5项目才 10 天稳定吗作者迭代极快几乎每天发版核心链路实测稳定。建议学习用途直接上批量重要资料转换前先转一条试效果关注 Releases 更新。八、总结course2md 把「看视频记笔记」这件事自动化了画面变化自动截图、讲课内容自动按时间轴整理B站收藏夹里的课程终于有了变成「真正学过」的出口。桌面版解压即用v2 新增、CLI 单文件 8.4MB两种形态都是下载即用、本地运行、免费开源。适合所有在用视频学习的人——尤其是收藏夹吃灰严重的同学先把一门课转成笔记你会立刻明白它的价值。完整命令速查# 0. 环境一次性装视频工具winget install--id Gyan.FFmpeg-e winget install--id yt-dlp.yt-dlp-e# 1. 下载CLI 单文件8.4MB或桌面版 zip16.1MB# https://github.com/mizorewww/course2md/releases 选对应包# 2. 自检环境.\course2md-windows-x86_64.exe doctor# 3. 转换本地视频 同名字幕在线视频直接换成 URL.\course2md-windows-x86_64.exe.\lecture.mp4-o.\notes--transcript-source subtitle# 4. 常用补充命令.\course2md-windows-x86_64.exe--login bilibili# 扫码登录 B 站.\course2md-windows-x86_64.exe models download# 预下载本地识别模型2.4GB.\course2md-windows-x86_64.exe config show# 查看配置含截图阈值参数.\course2md-windows-x86_64.exe llm setup# 可选配置 AI 润色项目地址[mizorewww/course2md] (https://github.com/mizorewww/course2md)标签course2md、视频转笔记、B站笔记、网课笔记、学习效率、开源工具、Rust、语音识别、Markdown、笔记软件、免费软件、效率工具