Nos termos do próprio skill
O md-slides converte um deck em markdown em uma apresentação HTML de arquivo único que roda em qualquer navegador. Um deck é composto por slides separados por delimitadores HR --- ou títulos H1, com blocos opcionais de notas do apresentador <!-- notes: ... -->. Um pipeline de três scripts Python da stdlib: slide_splitter.py, presenter_notes_parser.py, deck_html_renderer.py.
A saída inclui navegação por teclado, deep linking via hash na URL, uma barra de progresso e contador de slides, modo apresentador com relógio e pré-visualização do próximo slide, e uma folha de estilo de impressão para exportação em PDF com um slide por página. Ele reutiliza o parser de markdown do md-document e lê os tokens do design system via config_loader.py. Ele rejeita entradas sem limites claros de slide, decks com apenas 1 slide, arquivos com menos de 100 linhas e decks que não atingem a cobertura de 50% em --strict-notes.
O que ele produz
- O deck HTML renderizado, gravado como deck-{slug}.html no diretório de saída padrão resolvido, com -2, -3 e assim por diante anexados em caso de colisões.
- Arquivos JSON intermediários que armazenam os slides divididos e, depois, os slides com suas notas anexadas.
- Um PDF com um slide por página, gerado por meio da folha de estilo de impressão ao imprimir a partir do navegador.
Como funciona
- 01Dividir o Deck em Slides Ordenados
O slide_splitter.py lê o markdown de origem e o divide em linhas HR --- ou títulos H1, detectando automaticamente o estilo de delimitação por padrão, e grava uma lista ordenada de slides.
- 02Anexar Notas do Apresentador por Slide
O presenter_notes_parser.py examina cada slide em busca de blocos de notas e os anexa a esse slide, para que o modo apresentador tenha algo a mostrar no painel do lado direito.
- 03Renderizar o Deck HTML de Arquivo Único
O deck_html_renderer.py combina os slides com os tokens do design system e gera o deck, recebendo um título e um caminho de saída pela linha de comando.
- 04Aplicar Tokens do Design System
Doze custom properties CSS de marca vêm do design system, e o design_style altera a densidade dos layouts dos slides.
- 05Recusar Entradas Que Não Sejam Apresentações
O skill encerra em vez de converter quando a entrada não tem limites de slide claros, resultaria em um único slide ou falha no gate de cobertura de notas sob --strict-notes.