@slidev/cli 52.11.4 → 52.12.0

package/skills/slidev/references/syntax-block-frontmatter.md

@@ -0,0 +1,39 @@
+---
+name: block-frontmatter
+description: Using YAML code blocks as slide frontmatter for syntax highlighting
+---
+
+# Block Frontmatter
+
+Use a YAML code block as the frontmatter for slides when you need syntax highlighting and formatter support.
+
+## Usage
+
+Instead of traditional frontmatter `---`, use a yaml code block at the start of a slide:
+
+````md
+---
+theme: default
+---
+
+# Slide 1
+
+---
+
+```yaml
+layout: quote
+```
+
+# Slide 2
+
+---
+
+# Slide 3
+````
+
+## Key Points
+
+- Works for per-slide frontmatter only
+- Cannot use for headmatter (first frontmatter of the deck)
+- Provides syntax highlighting in editors
+- Compatible with prettier-plugin-slidev

package/skills/slidev/references/syntax-frontmatter-merging.md

@@ -0,0 +1,49 @@
+---
+name: frontmatter-merging
+description: Priority rules when importing slides with conflicting frontmatter
+---
+
+# Frontmatter Merging
+
+When importing slides, frontmatter from main entry takes priority.
+
+## Example
+
+Main file (`slides.md`):
+```md
+---
+src: ./cover.md
+background: https://sli.dev/bar.png
+class: text-center
+---
+```
+
+Imported file (`cover.md`):
+```md
+---
+layout: cover
+background: https://sli.dev/foo.png
+---
+
+# Cover
+
+Cover Page
+```
+
+## Result
+
+```md
+---
+layout: cover
+background: https://sli.dev/bar.png  # main entry wins
+class: text-center
+---
+
+# Cover
+
+Cover Page
+```
+
+## Priority Rule
+
+Main entry > Imported file for duplicate keys.

package/skills/slidev/references/syntax-importing-slides.md

@@ -0,0 +1,60 @@
+---
+name: importing-slides
+description: Split presentations into multiple files for reusability
+---
+
+# Importing Slides
+
+Split presentations into multiple files for reusability.
+
+## Basic Import
+
+```md
+# Title
+
+This is a normal page
+
+---
+src: ./pages/toc.md
+---
+
+<!-- Content here is ignored -->
+
+---
+
+# Page 4
+
+Another normal page
+```
+
+## Import Specific Slides
+
+Use hash to select slides:
+
+```md
+---
+src: ./another-presentation.md#2,5-7
+---
+```
+
+Imports slides 2, 5, 6, and 7.
+
+## Reuse Slides
+
+Import the same file multiple times:
+
+```md
+---
+src: ./pages/toc.md
+---
+
+<!-- later... -->
+
+---
+src: ./pages/toc.md
+---
+```
+
+## Frontmatter Priority
+
+Main entry frontmatter overrides imported file frontmatter for duplicate keys.

package/skills/slidev/references/syntax-mdc.md

@@ -0,0 +1,51 @@
+---
+name: mdc
+description: MDC (Markdown Components) syntax support
+---
+
+# MDC Syntax
+
+Enhanced Markdown with component and style syntax.
+
+## Enable
+
+```md
+---
+mdc: true
+---
+```
+
+## Inline Styles
+
+```md
+This is a [red text]{style="color:red"}
+```
+
+## Inline Components
+
+```md
+:inline-component{prop="value"}
+```
+
+## Image Attributes
+
+```md
+![](/image.png){width=500px lazy}
+```
+
+## Block Components
+
+```md
+::block-component{prop="value"}
+The **default** slot content
+::
+```
+
+## Use Cases
+
+- Add inline styles without HTML
+- Use Vue components inline
+- Add attributes to images
+- Create complex component layouts
+
+Based on Nuxt's MDC (Markdown Components) syntax.

package/skills/slidev/references/tool-eject-theme.md

@@ -0,0 +1,27 @@
+---
+name: eject-theme
+description: Extract theme to local filesystem for customization
+---
+
+# Eject Theme
+
+Extract installed theme to local filesystem for customization.
+
+## Command
+
+```bash
+slidev theme eject
+```
+
+## Result
+
+- Theme files copied to `./theme/`
+- Frontmatter updated to `theme: ./theme`
+
+## Use Case
+
+- Full control over theme
+- Create new theme based on existing one
+- Customize without modifying node_modules
+
+If creating a derivative theme, credit the original theme and author.