Slidev migration
Slidev migration documentation for Honeydeck.
Slidev migration
Coming from Slidev? Honeydeck ships an optional slidev-migration agent skill that can help an AI coding agent initialize a Honeydeck project and migrate a Slidev deck.
Install the skill
During a new project init, choose the agent skills installer:
npx @honeydeck/honeydeck init --name my-talk --install-skillFor an existing project, run:
honeydeck skillOr install from the Honeydeck repository when the repository URL is finalized:
npx skills add <honeydeck-repo-url> --copy --skill slidev-migrationThe same skills flow lets you choose project or global installation.
What it migrates
The skill guides an agent through the common Slidev-to-Honeydeck mapping:
| Slidev | Honeydeck |
|---|---|
slides.md | deck.mdx |
pages/*.md with src: includes | imported .mdx slide groups |
public/** | public/** |
components/*.vue | React components/*.tsx |
layouts/*.vue or Slidev themes | Honeydeck layouts, layout maps, React components, and CSS |
<v-click> / <v-clicks> | <Reveal> / <RevealGroup> |
Slidev Magic Move code blocks (md magic-move) | Honeydeck Magic Code blocks (md magic-code) |
| trailing note comments | <Notes> |
slidev, slidev build, slidev export | honeydeck dev, honeydeck build, honeydeck pdf |
The migration skill rewrites Slidev md magic-move code animation blocks to Honeydeck's canonical md magic-code syntax. Honeydeck still accepts md magic-move as a compatibility alias.
Advanced Slidev features such as Vue directives, $clicks, custom theme internals, Monaco/live-code blocks, and complex click positioning may need React-specific follow-up after the first migration pass.