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.