# Markdown Slides > Convert markdown into self-contained HTML slide presentations with keyboard navigation. - Skill: `johnalbertini14-glitch/markdown-slides` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add johnalbertini14-glitch/markdown-slides` - Raw SKILL.md: https://api.skillmd.com/api/skills/johnalbertini14-glitch/markdown-slides/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Web & Frontend - Author: johnalbertini14-glitch (https://skillmd.com/u/johnalbertini14-glitch) - Updated: 2026-09-21 - Page: https://skillmd.com/skills/johnalbertini14-glitch/markdown-slides --- # Markdown Slides Convert markdown into standalone HTML slide decks — zero dependencies, works offline. **Use when** creating presentations from markdown, quick slide decks, or demo presentations. ## Requirements - No external tools, build steps, or API keys - Output: single HTML file, works in any browser ## Instructions 1. **Parse input** — Split markdown content on `---` (horizontal rule) to create individual slides. 2. **Convert markdown to HTML** for each slide: - `# heading` → `

` (title slides) - `## heading` → `

` (section headers) - `- item` → `

` (bullet lists) - `**bold**` → ``, `*italic*` → `` - `` `code` `` → ``, code blocks → `` - `![alt](url)` → `` - Paragraphs → `` 3. **Wrap in HTML template** with embedded CSS and JavaScript: ```html PRESENTATION_TITLE ``` 4. **Save** as `slides.html` (or user-specified path). 5. **Tell the user**: Open in browser, use ←/→ arrows or click to navigate, F11 for fullscreen. ## Customization Options | Option | Default | Alternatives | |--------|---------|-------------| | Theme | Dark (#1a1a2e) | Light (#fff), Solarized | | Font | System UI | Monospace, Serif | | Accent | #667eea | Any hex color | | Ratio | 16:9 (viewport) | Can add letterboxing | ## Edge Cases - **No `---` separators**: Treat each `# heading` as a slide break. - **Very long slides**: Content may overflow. Suggest splitting into multiple slides. - **Images**: Must be URLs or base64-encoded. Local file paths won't work in standalone HTML. - **Code-heavy slides**: Reduce font size for `` blocks on those slides. - **Speaker notes**: Can add `` comments (hidden from view).