reveal-md-converter

Convert Reveal.js HTML decks into data-markdown template slide decks.

2|2|Updated Oct 1, 2017
One-click install
npx skills add https://github.com/pwr-piisw/wyklady --skill reveal-md-converter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reveal-md-converter
Source: https://github.com/pwr-piisw/wyklady/tree/main/.claude/skills/reveal-md-converter
Command: npx skills add https://github.com/pwr-piisw/wyklady --skill reveal-md-converter

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Convert a reveal.js deck from pure-HTML slide markup (lots of <section> elements with HTML inside) into the Markdown-template form used by examples/cbm-deck.html — a single <section data-markdown data-separator-vertical="^--$"> containing a <script type="text/template"> with all slides as Markdown, separated by --- (horizontal) and -- (vertical). Triggers when the user asks to "convert this deck to markdown", "rewrite this slideshow as md", "port slides to data-markdown", or supplies a reveal.js HTML deck and asks for the cbm-deck-style version. Writes a sibling file (e.g. foo-md.html) and leaves the source untouched.

Core Features & Use Cases

  • Converts top-level HTML slide decks into a single Markdown template that can be rendered in data-markdown mode.
  • Produces a sibling -md.html file next to the source while preserving the original deck's head, config, and external assets.
  • Ideal for porting existing HTML decks to Markdown-based workflows, enabling sharing, archiving, and reproducible rendering.

Quick Start

Run reveal-md-converter on a Reveal.js deck to generate a -md.html file beside the source without modifying the original deck.

Frequently Asked Questions about reveal-md-converter

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

FAQPage Schema
How do I convert a reveal.js HTML deck to a markdown template?

To convert a reveal.js deck to markdown, the tool transforms multiple <section> HTML elements into a single data-markdown template containing a <script type="text/template"> block with slides separated by --- and --. It outputs a sibling -md.html file beside the source.

What is the data-markdown template format in reveal.js?

The data-markdown template format uses a single <section data-markdown data-separator-vertical="^--$"> containing a <script type="text/template"> with all slides written in Markdown, separated by --- for horizontal slides and -- for vertical slides.

Can I port existing HTML slides to data-markdown mode without losing my config and scripts?

Yes, converting an HTML deck to the markdown template preserves the original deck's head content, config, and external assets. The tool writes a sibling -md.html file and leaves the source deck completely untouched.

Does the reveal.js markdown converter modify my original slideshow file?

No, the converter does not modify the original slideshow file. It generates a new sibling file with an -md.html extension next to the source, ensuring the original reveal.js HTML deck remains untouched.

When do I need to use data-separator-vertical in a reveal.js markdown deck?

You need data-separator-vertical when structuring vertical slides in a data-markdown template. The converter maintains compatibility with the cbm-deck.html style by setting data-separator-vertical to ^--$ to distinguish vertical slides from horizontal ones.