srt-to-markdown

Convert SRT subtitle files into structured Markdown documents with paragraphs.

3|2|Updated Mar 14, 2026

Search Tags:#transcript #markdown #structure #srt #asr #text-cleaning

Ready to run

npx skills add https://github.com/wzh4464/claude-skills --skill srt-to-markdown

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: srt-to-markdown
Source: https://github.com/wzh4464/claude-skills/tree/main/srt-to-markdown
Command: npx skills add https://github.com/wzh4464/claude-skills --skill srt-to-markdown

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

将 SRT 字幕文件整理为结构完整、行文通顺的 Markdown 文档，提升可读性与可出版性。

Core Features & Use Cases

将一个或多个 SRT 文件中的文本提取、清洗并合并为段落
根据断句标点和语气添加标点，提升可读性
将口语化文本转化为书面语风格，同时保留讲者风格
输出带章节结构的 Markdown 文档，适用于讲座、访谈、会议记录等场景

Quick Start

将一个或多个 SRT 文件转换为结构化的 Markdown 文档，包含段落、标点、并可选分章输出。

Frequently Asked Questions about srt-to-markdown

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I convert SRT subtitles into a readable Markdown document?▼

To convert SRT subtitles into a readable Markdown document, you extract the text, apply text normalization and punctuation restoration, then merge spoken lines into structured paragraphs for publishing.

What is the best way to clean up spoken transcripts from interviews for publishing?▼

The best way to clean up spoken interview transcripts is to merge fragmented subtitle lines into cohesive paragraphs and transform colloquial text into a structured, written style while preserving the speaker's original tone.

Can I process multiple SRT files to generate one structured Markdown transcript?▼

Yes, you can process multiple SRT files to generate a single structured Markdown transcript, applying paragraph merging and optional chapter hints to organize lecture or meeting records cohesively.

How does punctuation restoration work for ASR generated text?▼

Punctuation restoration for ASR generated text works by analyzing sentence breaks and speech tones, adding appropriate punctuation to clean subtitles and significantly improving overall text readability.

Does converting SRT to Markdown support adding chapter structures for long lectures?▼

Yes, converting SRT to Markdown supports adding chapter structures for long lectures by utilizing optional chapter hints within the input files to segment the final document logically.

Why do I need paragraph merging when converting subtitles to text?▼

You need paragraph merging when converting subtitles to text because raw SRT files contain fragmented spoken lines that require consolidation and text cleaning to form publishable, continuous prose.