← ClaudeAtlas

ppt-to-notes-mdlisted

把课件(.pptx/.ppt/.pdf)转成可在 Typora 里独立阅读的中文 Markdown 复习笔记——课件原文用白底正文、整理者的解释用灰底引用块、重点概念用 ==高亮==、关键图按需自动裁切并编号、每段标 PPT 页码。当用户提供 PPT/PPTX/PDF 课件并要求做笔记、整理复习资料、转成 markdown、总结课件、做考前提纲、把课件转笔记时,务必使用本技能;即使用户没说「笔记」二字,只要输入是课件、要输出的是可阅读的文字资料,就用它。产出笔记时本技能优先于 pptx / ppt-master(那两者负责改 PPT 和做 PPT,不负责把课件变成笔记)。不要用于:修改或生成 PPT、只提取纯文本、对 PDF 做问答。
vegness/ppt-to-notes-md · ★ 1 · Data & Documents · score 65
Install: claude install-skill vegness/ppt-to-notes-md
# 课件转 Markdown 笔记 目标只有一个:产出**一份脱离课件也能读懂**的中文复习笔记。所有规则都是为了让这件事成立——原文必须出现在笔记里,读者不需要翻回 PPT 才能补全句子。 ## 成品长什么样 ```markdown > 源文件:第4章 树与二叉树.pptx | 总页数:64 | 页码基准:幻灯片序号 # 4 树与二叉树 ## 4.1 树的定义 树是 n(n≥0)个结点的有限集合。n=0 时称为空树;n>0 时,有且仅有一个特定的结点称为根,其余结点可分为 m(m≥0)个互不相交的有限集合,每个集合本身又是一棵树。(PPT P12) > 定义的落点在「互不相交」——它同时给出了树的判定方法:能拆成互不相交的子树就是树,出现交叉就不是。 **例(PPT P13)** 判断下列结构是否为树:…… > 只要检查任意两结点间是否只有一条路径即可。 ``` 注意:元信息块也是引用块,但它是固定头部,不算解释。除此之外**凡灰底皆解释,白底皆是课件原文**。这张样例就是验收标准,下面的每条规则都在解释它为什么长这样。 ## 开工前 | 项 | 说明 | |---|---| | 脚本 | 与本文件同级的 `scripts/` 目录 | | Python | `C:/Users/50416/.workbuddy/binaries/python/envs/default/Scripts/python.exe`(已装 python-pptx / pymupdf / Pillow / pywin32,不要重复安装) | | 笔记输出 | `<课件所在目录>/notes/<原文件名>-notes.md` | | 插图输出 | `<课件所在目录>/notes/img/<笔记名>-图X.Y.png` | | 中间产物 | `<课件所在目录>/_ppt2notes_tmp/`,交付前删除 | 用户指定了根目录、或一次给了多个目录的课件时,所有产物统一落到 `<根>/notes/`。`img/` 扁平存放,靠文件名前缀区分不同笔记。 命名冲突(同名课件)时在 `notes/` 内加 `-2` 后缀,绝不覆盖已有笔记。 ## 七步工作流 ### 1. 抽取结构 ```bash python <skill>/scripts/extract.py "课件.pptx" -o _ppt2notes_tmp/slides.json ``` 读这份 JSON。它是唯一可信的原文来源——**写笔记时逐字取自这里,不要凭对课件的印象复述**,这是保证「引用原文」不走样的前提。 若脚本报「全部页面无文本层」,说明是扫描件,直接停下告诉用户需要先 OCR,不要硬猜内容。 ### 2. 渲染整页 ```bash python <skill>/scripts/render_pages.py "课件.pptx" -o _ppt2notes_tmp/pages ``` ### 3. 规划,再动笔 先定三件事,写进一份临时提纲(不必给用户看,除非页数超过 80): 1. **分节**:按第 4 节「标题与顺序」的规则决定哪些标题照抄、哪些重写。 2. **详略**:逐页打上 L1/L2/L3 标签(见第 6 节)。 3. **配图**:标出哪几页需要截图(见第 7 节)。 超过 80 页的课件,把分节提纲先给用户确认一次,避免写完 60 页发现结构不合意。 ### 4. 写正文 严格照第 5 节的标记约定。一次写完整节,不要边写边改格式—