md-to-slides

A skill for GitHub Copilot and Claude Code that turns Markdown presentation outlines into self-contained HTML decks.

Getting Started

The package now ships the md2slides CLI alongside the skill assets.

• Install the cli tool (only need to do this once)

npm install md-to-slides

• From your project root, install the skill

md2slides init

If you want direct-file usage, portable skill installs, or other setup variants, use the docs linked below instead of the main onboarding path.

Learn the workflow

• docs/quickstart.md — npm-first quickstart and current CLI status
• docs/install-options.md — portable skill-folder, script, archive, and clone-based installs
• docs/architecture-overview.md — contract, templates, examples, and portability model
• docs/repository-structure.md — repository layout and folder ownership
• docs/testing.md — root validation flow, fixtures, and release checks
• docs/automation.md — GitHub Actions and screenshot automation
• docs/publishing.md — publishing and package status

Quick Example

Use the presentation skill to create a 5-slide deck about adopting TypeScript.
Title: "Why TypeScript?" Audience: JavaScript developers. Tone: practical.

The workflow produces a single slides.html file you can open in any browser.

Visual Examples

| Minimal Talk | Technical Talk | | --- | --- | | Clean starter deck. Open → | Code-heavy engineering presentation. Open → |

| Executive Pitch | Workshop Tutorial | | --- | --- | | Concise business-facing narrative. Open → | Hands-on teaching flow with guided steps. Open → |

Contributing

Contributions welcome. Start with docs/repository-structure.md and docs/testing.md.

License

MIT License. See LICENSE for full text.

Copyright (c) Bruno Capuano & Contributors