Md2video-audio

Overview

md2video-audio converts a Markdown document into a narrated MP4 video by transforming the source into synchronized presentation visuals and spoken narration.

The workflow preserves the original file and generates separate presentation, narration, and video outputs.

• source_repo: 70v-Yoyo/md2video-audio-skill
• source_type: community

When to Use This Skill

• Use when converting Markdown tutorials, reports, or presentations into narrated videos.
• Use when creating presentation-style videos.
• Use when the user asks for Markdown-to-video, narrated slides, or audio-video generation.

How It Works

Step 1: Check Environment

Verify required local dependencies before running the workflow. Do not install, remove, or modify dependencies without user confirmation.

Step 2: Prepare the Markdown

Keep the original file unchanged.

Create a new Markdown file with improved sectioning, formatting, and natural transitions while preserving the original meaning.

Step 3: Generate Presentation Markdown

Convert the prepared document into Marp-compatible slides.

• Separate slides with ---.
• Prevent content overflow.
• Split oversized tables, code blocks, or sections when necessary.
• Ask the user to choose a Marp style when required.

Step 4: Generate Narration

Create a narration Markdown file aligned one-to-one with the presentation slides.

Remove visual-only characters that should not be spoken and verify that slide separators remain synchronized.

Step 5: Generate Video

Run the provided video-generation script with the presentation and narration files:

python ai-2md2marp2av.py presentation.md narration.md

The script renders Marp slides, generates speech with Edge-TTS, and combines them into an MP4 video.

Ask the user to complete any interactive input required by the script.

Step 6: Fallback

If the primary workflow fails, try the included fallback scripts in order:

python md2marp2av.py

Then:

python md2video.py

Examples

Example 1: Convert a Tutorial

/md2video-audio tutorial.md

Produces presentation Markdown, narration Markdown, and a narrated MP4 video.

Example 2: Convert a Work Report

/md2video-audio project-review.md

Use the generated slides and narration to create a presentation-style report video.

Best Practices

• ✅ Preserve the original Markdown file.
• ✅ Keep presentation and narration slide counts synchronized.
• ✅ Split slides that exceed safe layout limits.
• ✅ Confirm before installing dependencies or running interactive actions.
• ❌ Do not overwrite the source document.
• ❌ Do not silently install, remove, or modify system dependencies.

Limitations

• Requires the local runtime and dependencies used by the included scripts.
• Complex Markdown layouts may require manual adjustment.
• Edge-TTS availability depends on the local network and runtime environment.
• Stop and ask for clarification when required files, permissions, or user choices are missing.

Security & Safety Notes

• Run scripts only in a local or authorized environment.
• Confirm with the user before installing dependencies or making environment changes.
• Generated files should be written as new files rather than replacing source content.
• Do not execute interactive or destructive commands without explicit user confirmation.

Common Pitfalls

• Problem: Presentation and narration contain different slide counts. Solution: Verify the number of --- separators and realign the narration.
• Problem: Slide content overflows the Marp layout. Solution: Split the content into smaller logical sections before rendering.
• Problem: Video generation fails because dependencies are unavailable. Solution: Verify the environment first, then use the fallback scripts if appropriate.