Metadata-Version: 2.5
Name: md2video-audio-skill
Version: 1.1.1
Summary: One Markdown file + a one-click command = presentation-style video with synchronized narration. ｜ 一个 Markdown 文件 + 一键命令 = 专业级口播视频。
Project-URL: Homepage, https://github.com/70v-Yoyo/md2video-audio-skill
Project-URL: Bug-Tracker, https://github.com/70v-Yoyo/md2video-audio-skill
Project-URL: Repository, https://github.com/70v-Yoyo/md2video-audio-skill
Author: 70v-Yoyo
License: Apache-2.0
License-File: LICENSE
Keywords: Audio,Markdown,Skill,Video,ai-agent,claude-code,markdown-to-video,text-to-speech,video-generation
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Multimedia :: Video :: Conversion
Requires-Python: >=3.8
Description-Content-Type: text/markdown

[![PyPI Downloads](https://static.pepy.tech/personalized-badge/md2video-audio-skill?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=GREEN&left_text=downloads)](https://pepy.tech/projects/md2video-audio-skill)  [![README Views](https://visitor-badge.laobi.icu/badge?page_id=70v-Yoyo.md2video-audio-skill&left_text=README%20Views)](https://github.com/70v-Yoyo/md2video-audio-skill) [![skills.sh](https://skills.sh/b/70v-Yoyo/md2video-audio-skill)](https://skills.sh/70v-Yoyo/md2video-audio-skill)  [![License](https://img.shields.io/github/license/70v-Yoyo/md2video-audio-skill?style=flat-square)](https://github.com/70v-Yoyo/md2video-audio-skill/blob/main/LICENSE) 

---

能被你 `git clone` 或是阅读，是作为作者最开心的事！如果它解决了你的问题，不妨点亮右上角的小星星，不仅防止找不到仓库，还能动态推送追更哦。

💖 **用一个免费的 ⭐ Star 帮我加速吧！Thank You !** 

**⚠️ This project uses an unofficial interface to Microsoft Edge's online text-to-speech service and is intended for personal, educational, and experimental use only. Commercial use is not supported.**

---

# md2video-audio-skill

One Markdown file + a one-click command = presentation-style video with synchronized narration. ｜ 一个 Markdown 文件 + 一键命令 = 专业级口播视频。

- ✨ `/md2video-audio` 是什么神仙技能？

这是一个**完全免费**的 Markdown 转视频技能，能把你的 `.md` 文件直接编译成带真人配音的 MP4 视频：

```
Markdown 文档 → Marp 幻灯片 + Edge-TTS 配音 → 成品 MP4
```

- 🔥 核心亮点

| 特性           | 说明                                      |
| -------------- | ----------------------------------------- |
| 💰 **零成本**   | 不用 OpenAI、不用阿里云、不用任何付费 API |
| 🎙️ **真人配音** | 微软 Edge-TTS 音色，自然到以为是真人录的  |
| 🖼️ **自动配图** | Marp 渲染精美幻灯片作为讲解画面           |
| ⚡ **一键生成** | 一条命令搞定全部流程                      |
| **标准输出**   | 直接产出可上传抖音/B 站/YouTube 的 MP4    |

---

## 🚀 怎么用？超简单！

```bash
#安装方法
#1 npx安装
npx skills add https://www.modelscope.cn/skills/nihaoModelscope/md2video-audio-skill
#2 SDK安装
pip install --upgrade modelscope
modelscope skills add nihaoModelscope/md2video-audio-skill
#3 bash安装
curl -fsSL https://www.modelscope.cn/skills/install.sh | bash -s -- nihaoModelscope/md2video-audio-skill
#4 skill.sh安装
npx skills add 70v-Yoyo/md2video-audio-skill

#使用方法
# 在 Claude Code 里输入： 其他agent也可轻松适配
/md2video-audio your-presentation.md
```

就这样。没有复杂配置，只需要 AI API Key，除此之外不依赖任何额外付费服务。

----

- 适合什么场景？

-  **知识分享**：技术教程、读书笔记、概念讲解
-  💼 **工作汇报**：项目复盘、数据分析、进度同步  
-  **在线课程**：课件转视频、微课制作
-  📢 **营销内容**：产品介绍、功能演示、活动预告
-  **个人 IP**：日更视频、观点输出、经验总结

---

- 💡 为什么推荐它？

1. **真的免费** —— 很多类似工具最后都要你买积分、充会员，这个是纯本地方案
2. **质量靠谱** —— 目前最自然的中文 TTS 免费配音
3. **门槛极低** —— 会写 Markdown 就会用，不用学 Premiere
4. **可控性强** —— 文案改 MD 就行，不用重新录制

-----



# md2video-audio-skill- EN

One Markdown file + a one-click command = presentation-style video with synchronized narration.

✨ What kind of magical skill is `/md2video-audio`?

This is a completely free Markdown-to-video skill that directly compiles your `.md` files into MP4 videos with realistic human-like voiceovers:

Markdown Document → Marp Slides + Edge-TTS Voice → Finished MP4

🔥 Core Highlights

| **Feature**              | **Description**                                              |
| ------------------------ | ------------------------------------------------------------ |
| 💰 Zero Cost              | No OpenAI, no Alibaba Cloud, no paid APIs required.          |
| 🎙️ Realistic Voiceover    | Powered by Microsoft Edge-TTS voice, so natural it sounds like a real person. |
| 🖼️ Auto-Generated Visuals | Uses Marp to render stunning slides as presentation visuals. |
| ⚡ One-Click Generation   | Complete the entire workflow with a single command.          |
| 📦 Standard Output        | Directly produces MP4 videos ready to upload to TikTok, Bilibili, or YouTube. |

🚀 How to use? Super simple!

- Installation Methods

1. npx installation

`npx skills add https://www.modelscope.cn/skills/nihaoModelscope/md2video-audio-skill`

2. SDK installation

`pip install --upgrade modelscope modelscope skills add nihaoModelscope/md2video-audio-skill`

3. bash installation

`curl -fsSL https://www.modelscope.cn/skills/install.sh | bash -s -- nihaoModelscope/md2video-audio-skill`

4. skill.sh

`npx skills add 70v-Yoyo/md2video-audio-skill `

## Usage

- Type in Claude Code (easily adaptable for other agents):

`/md2video-audio your-presentation.md`

That's it. No complicated setup, no extra paid services — just your AI API key.

- Suitable Scenarios?

  - Knowledge Sharing: Tech tutorials, reading notes, concept explanations

  - 💼 Work Reports: Project reviews, data analysis, progress updates

  - Online Courses: Slide-to-video conversion, micro-lesson production

  - 📢 Marketing Content: Product introductions, feature demos, event announcements

  - Personal Branding: Daily video updates, opinion publishing, experience summaries

- 💡 Why recommend it?

  - Truly Free: Many similar tools eventually require buying credits or memberships; this is a purely local solution.

  - Reliable Quality: free and  natural TTS options available.

  - Extremely Low Barrier: If you can write Markdown, you can use it—no Premiere required.

  - High Controllability: Just edit the Markdown text to make changes, no need to re-record.

---

# Attribution

Based on [md2video-audio-skill](https://github.com/70v-Yoyo/md2video-audio-skill) by 70v-Yoyo.

Derivative works and redistributions must retain attribution to 70v-Yoyo and include the original repository address.
