En los propios términos del Skill
md-slides convierte un deck en markdown en una presentación HTML de un solo archivo que se ejecuta en cualquier navegador. Un deck son diapositivas separadas por límites --- HR o encabezados # H1, con bloques opcionales de notas del presentador <!-- notes: ... -->. Un pipeline de tres scripts de Python de la stdlib: slide_splitter.py, presenter_notes_parser.py, deck_html_renderer.py.
El resultado incluye navegación por teclado, enlaces profundos mediante hash en la URL, una barra de progreso y contador de diapositivas, modo presentador con reloj y vista previa de la siguiente diapositiva, y una hoja de estilos de impresión para exportar a PDF con una diapositiva por página. Reutiliza el analizador de markdown de md-document y lee los tokens del design system mediante config_loader.py. Rechaza entradas sin límites de diapositiva claros, decks de 1 diapositiva, archivos con menos de 100 líneas, y decks que no superan la cobertura del 50% de --strict-notes.
Qué produce
- El deck HTML renderizado, escrito como deck-{slug}.html en el directorio de salida predeterminado resuelto, con -2, -3, etc. añadidos en caso de colisiones.
- Archivos JSON intermedios que contienen las diapositivas divididas y luego las diapositivas con sus notas adjuntas.
- Un PDF con una diapositiva por página, producido mediante la hoja de estilos de impresión al imprimir desde el navegador.
Cómo funciona
- 01Dividir el Deck en Diapositivas Ordenadas
slide_splitter.py lee el markdown de origen y lo divide en líneas --- HR o encabezados H1, detectando automáticamente el estilo de límite por defecto, y escribe una lista ordenada de diapositivas.
- 02Adjuntar Notas del Presentador por Diapositiva
presenter_notes_parser.py analiza cada diapositiva en busca de bloques de notas y las adjunta a esa diapositiva, para que el modo presentador tenga algo que mostrar en el panel de la derecha.
- 03Renderizar el Deck HTML de un Solo Archivo
deck_html_renderer.py combina las diapositivas con los tokens del design system y genera el deck, tomando un título y una ruta de salida desde la línea de comandos.
- 04Aplicar Tokens del Design System
Doce propiedades personalizadas de CSS de marca provienen del design system, y design_style cambia la densidad de los diseños de las diapositivas.
- 05Rechaza Entradas que no Son Presentaciones
El skill se cierra en lugar de convertir cuando la entrada no tiene límites de diapositiva claros, generaría una sola diapositiva, o falla la verificación de cobertura de notas bajo --strict-notes.