DEV Community

AttentionIsImportant
AttentionIsImportant

Posted on

🌟Turn Markdown into Narrated Videos with a New AI Skill

I’ve been trying out a new Skill that turns Markdown content into narrated videos — and it’s surprisingly practical. The workflow is simple.

The biggest advantage is that it doesn’t just generate slides or audio separately — it can directly produce a complete video with synchronized audio.

In other words, the final output is an actual MP4 video with the generated narration already included:

Markdown → Slides + Audio → MP4 Video

You can also modify and build on top of the Skill to fit your own workflow. It is released under the Apache License 2.0, so you can customize, extend, and integrate it into your own projects, as long as you comply with the license requirements, including preserving the required attribution and license notices.

You write your content in Markdown, and the Skill handles the rest:

  • Converts Markdown into presentation slides with Marp
  • Generates narration with Edge-TTS (Text-to-Speech)
  • Synchronizes the slides and narration
  • Uses FFmpeg to produce the final MP4 video
  • Keeps the whole workflow local and scriptable

This is particularly useful for turning technical content into:

  • Programming tutorials
  • Course materials
  • Documentation
  • AI-generated educational content
  • Internal technical training
  • Short-form technical videos

The interesting part is that the input remains just Markdown.

That means an AI agent can generate the Markdown first, and the Skill can take it from there.

For example:

# What is a Transformer?

## Self-Attention

Self-attention allows each token to
consider other tokens in the sequence...

## Why does it matter?

It enables the model to capture
relationships between distant tokens.
Enter fullscreen mode Exit fullscreen mode

→ slides
→ narration
→ synchronized video

No video editor required.

The Skill is available here:

https://github.com/70v-Yoyo/md2video-audio-skill

If you regularly turn Markdown, documentation, or technical notes into educational content, this is worth trying.

Top comments (0)