markdown-video

Convert Deckset markdown slides with speaker notes into narrated MP4 videos.

49|9|Updated Nov 26, 2025
One-click install
npx skills add https://github.com/jykim/claude-obsidian-skills --skill markdown-video
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markdown-video
Source: https://github.com/jykim/claude-obsidian-skills/tree/main/markdown-video
Command: npx skills add https://github.com/jykim/claude-obsidian-skills --skill markdown-video

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Turning Deckset-format slides into a video with narration is complex. This skill orchestrates slide parsing, audio generation, image creation, and video assembly into a publish-ready MP4.

Core Features & Use Cases

  • Four workflows: Deckset+composite images, auto-generate, direct Deckset, Gemini-generated visuals.
  • Automated narration: Uses TTS to produce audio for slides with notes.
  • Slide-to-video assembly: Synchronizes visuals and audio into a cohesive final video.
  • Use Case: Create a complete narrated presentation from a Markdown source without manual editing.

Quick Start

Provide slides.md and run: markdown-video to generate a narrated presentation.

Frequently Asked Questions about markdown-video

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

FAQPage Schema
How do I convert Deckset markdown slides to an MP4 video with narration?

Convert Deckset-format markdown to MP4 by providing a slides.md file with speaker notes prefixed by ^ and images in _files_. The skill generates TTS audio via OpenAI, synchronizes it with slides, and outputs a 1920x1080 MP4 video using FFmpeg.

Can I automate creating narrated video presentations from markdown?

Yes. This skill automates the entire pipeline: parse Deckset markdown, generate narration using text-to-speech, create slide visuals, and assemble synchronized audio and video into a publish-ready MP4 without manual editing.

What formats and tools does the markdown-to-video workflow support?

The skill supports Deckset markdown input, integrates OpenAI for TTS narration, uses FFmpeg for video assembly, and offers four workflow variants including auto-generate and Gemini-generated visuals, outputting standard 1920x1080 MP4.

Do I need to manually edit audio or video after conversion?

No. The skill handles slide parsing, audio generation, image creation, and video assembly automatically. Output is publish-ready, eliminating manual synchronization and editing steps.

What are the limitations when converting slides to video with TTS?

The workflow requires Deckset-formatted markdown with speaker notes, OpenAI API access for TTS generation, and FFmpeg for video rendering. Complex animations or non-standard slide layouts may require preprocessing.

Related Skills