markdown-slides

Convert Markdown documents into Deckset/Marp-compatible slides with speaker notes.

49|9|Updated Nov 26, 2025
One-click install
npx skills add https://github.com/jykim/claude-obsidian-skills --skill markdown-slides
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markdown-slides
Source: https://github.com/jykim/claude-obsidian-skills/tree/main/markdown-slides
Command: npx skills add https://github.com/jykim/claude-obsidian-skills --skill markdown-slides

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converting Markdown into presentation slides can be tedious. This skill automates slide structure, image handling, speaker notes, and emoji enhancements for Deckset/Marp-ready slides.

Core Features & Use Cases

  • Slide structure setup: Logical slide divisions with proper hierarchy and optional frontmatter.
  • Image handling: Converts image references to presentation-friendly formats and resolves paths.
  • Speaker notes: Extracts and formats speaker notes for narration.
  • Emoji enhancements: Improves slide titles with relevant emojis for emphasis.
  • Use Case: Convert a detailed Markdown document into a polished deck with consistent slide breaks.

Quick Start

Tell Claude: "Convert my document.md to slides with Deckset formatting and - slides.md suffix."

Frequently Asked Questions about markdown-slides

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert Markdown documents into presentation slides?

Convert Markdown to presentation slides by using this Skill to automatically structure content with proper slide breaks, handle image paths, and format output as Deckset or Marp-compatible Markdown. The Skill generates a new file with a -slides suffix ready for presentation tools.

Does this work with Deckset and Marp slide formats?

Yes, this Skill outputs Deckset and Marp-compatible Markdown. It resolves image paths with URL encoding, escapes special characters, verifies image references exist, and preserves slide hierarchy to ensure compatibility with both formats.

How do I handle images when converting Markdown to slides?

The Skill automatically converts image references to presentation-friendly formats, resolves relative paths with proper URL encoding and escaped parentheses, and verifies all referenced images exist before generating the slide file.

Can I add speaker notes to my generated slides?

Yes, the Skill extracts and formats speaker notes from your Markdown source for narration during presentations. It preserves note structure alongside slide content in the output file.

What input formats does this Skill accept?

The Skill converts Markdown or document sources into Deckset/Marp-compatible slides. Provide a Markdown file as input, and the Skill outputs a formatted slide file with the -slides suffix in the same directory.

Can the Skill enhance slides with emojis?

Yes, the Skill optionally adds relevant emojis to slide titles for visual emphasis and improved readability in your presentation deck.