markdown-slides_skill

Overview

This skill converts source content into clean, presentation-ready Markdown slides compatible with Deckset and Marp. I produce properly divided slides, position images, and extract speaker notes while preserving the original content hierarchy. Output files are saved alongside the source with a "- slides" suffix and optional frontmatter like slide numbers.

How this skill works

I parse the source Markdown or outline, insert logical slide dividers (---), and map headers to H1/H2/H3 for sections, slides, and subtopics. I resolve and verify each image path, URL-encode and escape special characters, and apply Deckset/Marp positioning formats (e.g., ). Multi-sentence explanatory paragraphs are converted to speaker notes (^ prefix for Deckset; HTML comments for Marp). I then polish titles with selective emojis, remove internal comments, and add frontmatter if requested.

When to use it

• When you need to create a slide deck from Markdown, outline, or a document.
• When converting content to Deckset or Marp-compatible slide format.
• When slides require precise image placement, sizing, or path resolution.
• When you want speaker notes extracted from explanatory paragraphs.
• When you need consistent header hierarchy and slide breaks added automatically.

Best practices

• Start with a clear outline and one main idea per slide.
• Keep images only if files exist; I will not invent images for you.
• Use H1 for sections, H2 for slide titles, H3 for subpoints to preserve hierarchy.
• Default to for content slides and for section backgrounds.
• Enable speaker notes for multi-sentence explanations; keep lists on-slide.

Example use cases

• Turn a long Markdown article into a concise Deckset presentation with speaker notes.
• Prepare a product roadmap deck from an outline, with charts positioned right-fit.
• Convert a technical document into training slides and extract talking points.
• Polish slides for a conference by adding emojis, slide numbers, and frontmatter.
• Migrate content for Marp by switching speaker-note format to HTML comments.