Md2video-audio

Visão Geral

md2video-audio converte um documento Markdown em um vídeo MP4 narrado, transformando a fonte em visuais de apresentação sincronizados e narração falada.

O fluxo de trabalho preserva o arquivo original e gera saídas separadas de apresentação, narração e vídeo.

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

Quando Usar Esta Habilidade

• Use ao converter tutoriais, relatórios ou apresentações em Markdown em vídeos narrados.
• Use ao criar vídeos no estilo de apresentação.
• Use quando o usuário solicitar conversão de Markdown para vídeo, slides narrados ou geração de áudio-vídeo.

Como Funciona

Etapa 1: Verificar Ambiente

Verifique as dependências locais necessárias antes de executar o fluxo de trabalho. Não instale, remova ou modifique dependências sem a confirmação do usuário.

Etapa 2: Preparar o Markdown

Mantenha o arquivo original inalterado.

Crie um novo arquivo Markdown com seções, formatação e transições naturais aprimoradas, preservando o significado original.

Etapa 3: Gerar Markdown de Apresentação

Converta o documento preparado em slides compatíveis com Marp.

• Separe os slides com ---.
• Evite o transbordamento de conteúdo.
• Divida tabelas, blocos de código ou seções grandes quando necessário.
• Peça ao usuário para escolher um estilo Marp quando necessário.

Etapa 4: Gerar Narração

Crie um arquivo Markdown de narração alinhado um a um com os slides da apresentação.

Remova caracteres visuais que não devem ser falados e verifique se os separadores de slides permanecem sincronizados.

Etapa 5: Gerar Vídeo

Execute o script de geração de vídeo fornecido com os arquivos de apresentação e narração:

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

O script renderiza slides Marp, gera fala com Edge-TTS e os combina em um vídeo MP4.

Peça ao usuário para completar qualquer entrada interativa exigida pelo script.

Etapa 6: Fallback

Se o fluxo de trabalho principal falhar, tente os scripts de fallback incluídos em ordem:

python md2marp2av.py

Em seguida:

python md2video.py

Exemplos

Exemplo 1: Converter um Tutorial

/md2video-audio tutorial.md

Produz Markdown de apresentação, Markdown de narração e um vídeo MP4 narrado.

Exemplo 2: Converter um Relatório de Trabalho

/md2video-audio project-review.md

Use os slides e a narração gerados para criar um vídeo de relatório no estilo de apresentação.

Melhores Práticas

• ✅ Preserve o arquivo Markdown original.
• ✅ Mantenha a contagem de slides de apresentação e narração sincronizada.
• ✅ Divida slides que excedem os limites de layout seguros.
• ✅ Confirme antes de instalar dependências ou executar ações interativas.
• ❌ Não substitua o documento de origem.
• ❌ Não instale, remova ou modifique dependências do sistema silenciosamente.

Limitações

• Requer o ambiente de execução local e as dependências usadas pelos scripts incluídos.
• Layouts complexos de Markdown podem exigir ajuste manual.
• A disponibilidade do Edge-TTS depende da rede local e do ambiente de execução.
• Pare e peça esclarecimentos quando arquivos, permissões ou escolhas do usuário necessárias estiverem ausentes.

Notas de Segurança e Proteção

• Execute scripts apenas em um ambiente local ou autorizado.
• Confirme com o usuário antes de instalar dependências ou fazer alterações no ambiente.
• Os arquivos gerados devem ser gravados como novos arquivos, em vez de substituir o conteúdo de origem.
• Não execute comandos interativos ou destrutivos sem confirmação explícita do usuário.

Armadilhas Comuns

• Problema: Apresentação e narração contêm contagens de slides diferentes. Solução: Verifique o número de separadores --- e realinhe a narração.
• Problema: O conteúdo do slide excede o layout do Marp. Solução: Divida o conteúdo em seções lógicas menores antes de renderizar.
• Problema: A geração de vídeo falha porque as dependências não estão disponíveis. Solução: Verifique o ambiente primeiro, depois use os scripts de fallback, se apropriado.