$npx -y skills add yiliqi78/se7en-skills --skill se7en-doc-converter文档转写专家——将 PDF、Word、PPT 等文档转为 Markdown。 触发场景:上传文档、转写文档、导入文档、文档转 md、归档文档。 自动识别文档类型,转写为 .md 格式,支持自定义输出位置。
| 1 | # 文档转写与归档 |
| 2 | |
| 3 | ## 支持格式 |
| 4 | |
| 5 | | 格式 | 扩展名 | 处理方式 | |
| 6 | |------|--------|----------| |
| 7 | | PDF | .pdf | 提取文本,保留结构 | |
| 8 | | Word | .docx, .doc | 提取文本和格式 | |
| 9 | | PowerPoint | .pptx, .ppt | 按幻灯片提取,保留层级 | |
| 10 | | 纯文本 | .txt | 直接转换 | |
| 11 | |
| 12 | --- |
| 13 | |
| 14 | ## 处理流程 |
| 15 | |
| 16 | ### 1. 识别文档 |
| 17 | 读取用户上传的文档,识别: |
| 18 | - 文档类型 |
| 19 | - 主要内容主题 |
| 20 | - 适合的输出位置 |
| 21 | |
| 22 | ### 2. 内容转写 |
| 23 | 将文档内容转为 Markdown 格式: |
| 24 | - 保留标题层级(# ## ###) |
| 25 | - 保留列表、表格结构 |
| 26 | - 图片标注为 `[图片: 描述]` |
| 27 | - PPT 按幻灯片分节,标注页码 |
| 28 | |
| 29 | ### 3. 确定输出位置 |
| 30 | |
| 31 | 询问用户确认输出路径: |
| 32 | > 文档转写完成,建议保存为 `[建议文件名].md`。 |
| 33 | > 保存到哪里?(给个路径,或者我存到当前目录) |
| 34 | |
| 35 | ### 4. 写入文件 |
| 36 | 将转写内容写入确认的位置。 |
| 37 | |
| 38 | --- |
| 39 | |
| 40 | ## Markdown 转写规范 |
| 41 | |
| 42 | ### 标题 |
| 43 | ```markdown |
| 44 | # 一级标题(文档标题) |
| 45 | ## 二级标题(章节) |
| 46 | ### 三级标题(小节) |
| 47 | ``` |
| 48 | |
| 49 | ### 元信息(frontmatter) |
| 50 | ```markdown |
| 51 | --- |
| 52 | title: 文档标题 |
| 53 | source: 原文件名.pdf |
| 54 | converted: 2026-02-03 |
| 55 | tags: [标签1, 标签2] |
| 56 | --- |
| 57 | ``` |
| 58 | |
| 59 | ### PPT 特殊处理 |
| 60 | ```markdown |
| 61 | --- |
| 62 | ## 幻灯片 1: [标题] |
| 63 | [内容] |
| 64 | |
| 65 | --- |
| 66 | ## 幻灯片 2: [标题] |
| 67 | [内容] |
| 68 | ``` |
| 69 | |
| 70 | --- |
| 71 | |
| 72 | ## 注意事项 |
| 73 | |
| 74 | 1. **大文件分割**:超过 500 行考虑拆分为多个文件 |
| 75 | 2. **图片处理**:仅标注位置,不自动提取图片 |
| 76 | 3. **编码处理**:自动检测文件编码,优先 UTF-8 |