youtube-to-markdown

Extract YouTube video metadata and transcripts into structured Markdown documents.

11|2|Updated Nov 9, 2025
One-click install
npx skills add https://github.com/vre/flow-state --skill youtube-to-markdown
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: youtube-to-markdown
Source: https://github.com/vre/flow-state/tree/main/youtube-to-markdown
Command: npx skills add https://github.com/vre/flow-state --skill youtube-to-markdown

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires yt-dlp.

What problem does it solve?

This Skill automates the extraction of YouTube video data, including metadata, description, and chapters, and prepares a structured Markdown footprint that you can drop into any knowledge vault.

Core Features & Use Cases

  • Video data extraction: Pull video metadata (title, URL, uploader, views, duration) into a Markdown file for quick reference.
  • Description and chapters: Save the video description and chapter structure to improve navigation and searchability.
  • Markdown readiness: Outputs ready-to-use Markdown that can be dropped into Obsidian, Notion, or any note-taking system.
  • Use Case: Convert a set of relevant YouTube videos into a compiled knowledge base for a project, training, or research.

Quick Start

Use the youtube-to-markdown skill to extract data for a YouTube URL like https://www.youtube.com/watch?v=example. The skill will generate youtube_{id}metadata.md, youtube{id}description.md, and youtube{id}_chapters.json in your output directory, ready for final assembly.

Frequently Asked Questions about youtube-to-markdown

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

FAQPage Schema
How do I convert YouTube videos to Markdown for my knowledge base?

YouTube-to-markdown extracts video metadata, transcripts, descriptions, and chapters into a structured Markdown document. It outputs ready-to-use files containing video details, full transcription with timestamps, and chapter structure that you can import directly into Obsidian, Notion, or any note-taking system.

Can I extract transcripts and chapters from YouTube videos automatically?

Yes. The Skill uses yt-dlp to retrieve video metadata, accessible subtitles, and chapter information, then assembles them into Markdown with proper heading hierarchy and timestamp preservation. Transcripts are deduplicated and segmented into paragraphs for readability.

What video metadata does YouTube-to-markdown capture?

The Skill extracts title, URL, uploader, view count, duration, description, and chapter timestamps. All metadata is formatted into structured Markdown files that preserve searchability and language information while maintaining a single consolidated document per video.

Does YouTube-to-markdown work with videos that don't have captions?

The Skill is designed for videos with accessible metadata, descriptions, chapters, and subtitles. Performance depends on subtitle availability; videos without captions will extract metadata and chapter data but cannot generate full transcripts.

How do I build a searchable knowledge vault from multiple YouTube videos?

Run YouTube-to-markdown on each video URL to generate individual Markdown files containing metadata, transcripts, and chapters. Collect the output files into a single folder structure, then import them into your note-taking system to create a compiled, searchable knowledge base organized by video.

What's the difference between extracting metadata versus full transcription?

Metadata extraction captures title, uploader, views, and duration for quick reference. Full transcription captures the complete spoken content with timestamps and paragraph breaks. YouTube-to-markdown performs both—metadata for discoverability and transcription for content capture and searchability.