Nelle parole della skill
md-slides converte un deck markdown in una presentazione HTML a file unico eseguibile in qualsiasi browser. Un deck è composto da slide separate da confini HR --- o da titoli H1, con blocchi opzionali di note per il relatore <!-- notes: ... -->. Una pipeline di tre script Python stdlib: slide_splitter.py, presenter_notes_parser.py, deck_html_renderer.py.
L'output include navigazione da tastiera, deep linking tramite hash URL, una barra di avanzamento e il contatore delle slide, una modalità relatore con orologio e anteprima della slide successiva, e un foglio di stile per la stampa per l'esportazione in PDF con una slide per pagina. Riutilizza il parser markdown di md-document e legge i token del design system tramite config_loader.py. Rifiuta input senza confini di slide chiari, deck di 1 slide, file sotto le 100 righe e deck che non superano la copertura del 50% con --strict-notes.
Che cosa produce
- Il deck HTML generato, scritto come deck-{slug}.html nella directory di output predefinita risolta, con -2, -3 e così via aggiunti in caso di collisioni.
- File JSON intermedi che contengono le slide suddivise e poi le slide con le rispettive note allegate.
- Un PDF con una slide per pagina, prodotto tramite il foglio di stile per la stampa, stampando dal browser.
Come funziona
- 01Suddividere il Deck in Slide Ordinate
slide_splitter.py legge il markdown di origine e lo suddivide in base alle righe HR --- o ai titoli H1, rilevando automaticamente lo stile del confine per impostazione predefinita, e scrive un elenco ordinato di slide.
- 02Allegare Note per il Relatore a Ogni Slide
presenter_notes_parser.py analizza ogni slide alla ricerca di blocchi di note e li allega a quella slide, in modo che la modalità relatore abbia qualcosa da mostrare nel pannello a destra.
- 03Renderizzare il Deck HTML a File Unico
deck_html_renderer.py combina le slide con i token del design system e genera il deck, accettando un titolo e un percorso di output dalla riga di comando.
- 04Applicare i Token del Design System
Dodici proprietà CSS personalizzate del brand provengono dal design system, e design_style modifica la densità dei layout delle slide.
- 05Rifiuta Input Che Non Sono Presentazioni
Lo skill si interrompe invece di convertire quando l'input non ha confini di slide chiari, produrrebbe una singola slide, oppure non supera il gate di copertura delle note con --strict-notes.