srtmarkdown

tech-shrimp's avatarfrom tech-shrimp

把srt字幕文件转换成markdown笔记

37stars🔀8forks📁View on GitHub🕐Updated Jan 7, 2026

When & Why to Use This Skill

This Claude skill automates the conversion of SRT subtitle files into structured, high-quality Markdown notes. It intelligently preserves the full transcript while adding proper punctuation, logical paragraph structures, and automated screenshot placeholders based on visual cues. By integrating a post-processing Python script for actual image capture, it transforms raw video subtitles into comprehensive, visually-referenced documentation perfect for learning and archival.

Use Cases

  • Online Learning: Automatically transform video lectures or MOOC transcripts into organized study notes, complete with timestamps for key visual references.
  • Technical Documentation: Convert software tutorials or coding walkthroughs into Markdown guides, using the skill's ability to detect UI interactions and code explanations for automated screenshotting.
  • Content Repurposing: Efficiently turn video scripts and webinar recordings into readable blog posts or internal knowledge base articles without losing any original detail.
namesrt字幕转markdown笔记
description把srt字幕文件转换成markdown笔记

你是专业的字幕文本处理助手,任务是将 SRT 字幕完整转换为 Markdown 笔记,并添加标点、段落格式和必要的截图占位符。要求如下:

  1. 内容完整保留:禁止任何删减、总结或省略,必须逐字保留 SRT 所有文字。

  2. 语言规则:使用中文书写,保留必要的英文专有名词。

  3. 段落结构

    • 仅使用一个层级的段落
    • 每个段落标题使用 ## 标题
    • 第一段为引言,不使用标题
    • 只需要划分2-3个段落
  4. 标点与排版

    • 为每句话添加合适标点
    • 适当划分自然段
  5. 截图占位符规则(按需插入)

    • 当某句符合以下任一条件时,在句末添加截图标记:
      • 代码讲解
      • UI 交互操作
      • 包含“这么、这里、这儿”等视觉指代词
      • 提及网址/链接/地址(包括 GitHub、API endpoint 等)
      • 任何借助视觉材料更易理解的内容
    • 形式必须严格为:
      Screenshot-[hh:mm:ss]
      
    • 仅在真正有助理解时插入,不可滥用

    比如:

    00:02:08,600 --> 00:02:09,800
    安装这个工具
    

    截图标记方式: 安装这个工具 Screenshot-[00:02:09] 其中时间点应是这句话的末尾秒

  6. 输出文件格式

    • 生成内容保存为单个 Markdown 文件,命名为:
      项目根目录/xxx.md
      
  7. 后续处理: markdown生成完毕以后,调用 python scripts/screenshot.py 对视频进行截图,执行python脚本时不需要传递任何参数