其他
制作技术演示/代码讲解/教学材料时,用 Slidev…
适用于基于 Markdown 和 Vue 构建技术演示、会议演讲、代码走查、教学材料等开发者幻灯片,支持代码高亮、动画、图表、数学公式和交互功能。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 48/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 85/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 55/100 ×0.15
适用场景
制作技术演示/代码讲解/教学材料时,用 通用
解决思路
- 创建项目:运行 `pnpm create slidev` 创建 Slidev 项目。
- 启动开发服务器:运行 `pnpm run dev`,默认打开 `http://localhost:3030`。
- 构建静态 SPA:运行 `pnpm run build`。
- 导出 PDF:运行 `pnpm run export`。
- 验证开发:运行 `pnpm run dev` 后确认幻灯片能在 `http://localhost:3030` 加载。
- 验证导出:运行 `pnpm run export` 后确认项目根目录生成了输出 PDF。
- 基础 Markdown:用 `---` 分隔幻灯片。
- 基础 Markdown:把第一个 frontmatter 作为 headmatter,用于配置整套幻灯片。
- 基础 Markdown:用 HTML 注释 `<!-- ... -->` 写演讲者备注。
- 核心参考:查阅 references/core-syntax.md 了解 Markdown 语法、幻灯片分隔符、frontmatter、备注和代码块。
- 核心参考:查阅 references/core-animations.md 了解 v-click、v-clicks、motion、transitions。
- 核心参考:查阅 references/core-headmatter.md 了解整套幻灯片配置选项。
- 核心参考:查阅 references/core-frontmatter.md 了解单页幻灯片配置选项。
- 核心参考:查阅 references/core-cli.md 了解 dev、build、export、theme 命令。
- 核心参考:查阅 references/core-components.md 了解内置 Vue 组件。
- 核心参考:查阅 references/core-layouts.md 了解内置幻灯片布局。
- 核心参考:查阅 references/core-exporting.md 了解 PDF、PPTX、PNG 导出选项。
- 核心参考:查阅 references/core-hosting.md 了解构建和部署到不同平台。
- 核心参考:查阅 references/core-global-context.md 了解 `$nav`、`$slidev` 和 composables API。
- 代码行高亮:在代码块上使用 ```ts {2,3} 来高亮指定行;参考 references/code-line-highlighting.md。
- 基于点击的代码高亮:在代码块上使用 ```ts {1|2-3|all};参考 references/code-line-highlighting.md。
- 代码行号:设置 `lineNumbers: true` 或 `{lines:true}`;参考 references/code-line-numbers.md。
- 可滚动代码:使用 `{maxHeight:'100px'}`;参考 references/code-max-height.md。
- 代码标签页:使用 `::code-group`,并需要 `comark: true`;参考 references/code-groups.md。
- Monaco 编辑器:在代码块上使用 ```ts {monaco};参考 references/editor-monaco.md。
- 运行代码:在代码块上使用 ```ts {monaco-run};参考 references/editor-monaco-run.md。
- 编辑文件:使用 `<<< ./file.ts {monaco-write}`;参考 references/editor-monaco-write.md。
- 代码动画:使用 ````md magic-move```` 代码块;参考 references/code-magic-move.md。
- TypeScript 类型:在代码块上使用 ```ts twoslash;参考 references/code-twoslash.md。
- 导入代码:使用 `<<< @/snippets/file.js`;参考 references/code-import-snippet.md。
- Mermaid 图表:使用 ```mermaid 代码块;参考 references/diagram-mermaid.md。
- PlantUML 图表:使用 ```plantuml 代码块;参考 references/diagram-plantuml.md。
- LaTeX 数学:使用 `$inline$` 或 `$$block$$`;参考 references/diagram-latex.md。
- 画布尺寸:配置 `canvasWidth`、`aspectRatio`;参考 references/layout-canvas-size.md。
- 缩放幻灯片:设置 `zoom: 0.8`;参考 references/layout-zoom.md。
- 缩放元素:使用 `<Transform :scale="0.5">`;参考 references/layout-transform.md。
- 布局插槽:使用 `::right::`、`::default::`;参考 references/layout-slots.md。
- 作用域 CSS:在幻灯片内使用 `<style>`;参考 references/style-scoped.md。
- 全局图层:使用 `global-top.vue`、`global-bottom.vue`;参考 references/layout-global-layers.md。
- 可拖拽元素:使用 `v-drag`、`<v-drag>`;参考 references/layout-draggable.md。
- 图标:使用 `<mdi-icon-name />`;参考 references/style-icons.md。
- 点击动画:使用 `v-click`、`<v-clicks>`;参考 references/core-animations.md。
- 粗略标记(Rough markers):使用 `v-mark.underline`、`v-mark.circle`;参考 references/animation-rough-marker.md。
- 绘图模式:按 `C` 或配置 `drawings:`;参考 references/animation-drawing.md。
- 方向样式:使用 `forward:delay-300`;参考 references/style-direction.md。
- 备注高亮:在备注中使用 `[click]`;参考 references/animation-click-marker.md。
- Comark 语法:设置 `comark: true` 并使用 `{style="color:red"}`;参考 references/syntax-comark.md。
- 块级 frontmatter:用 ```yaml 代替 `---`;参考 references/syntax-block-frontmatter.md。
- 导入幻灯片:使用 `src: ./other.md`;参考 references/syntax-importing-slides.md。
- 合并 frontmatter:主入口优先;参考 references/syntax-frontmatter-merging.md。
- 录制:按 `G` 打开摄像头;参考 references/presenter-recording.md。
- 计时器:使用 `duration: 30min`、`timer: countdown`;参考 references/presenter-timer.md。
- 遥控:运行 `slidev --remote`;参考 references/presenter-remote.md。
- Ruby text:使用 `notesAutoRuby:`;参考 references/presenter-notes-ruby.md。
- 导出选项:运行 `slidev export`;参考 references/core-exporting.md。
- 构建与部署:运行 `slidev build`;参考 references/core-hosting.md。
- 构建时包含 PDF:设置 `download: true`;参考 references/build-pdf.md。
- 缓存图片:远程 URL 会自动缓存;参考 references/build-remote-assets.md。
- OG 图片:设置 `seoMeta.ogImage` 或提供 `og-image.png`;参考 references/build-og-image.md。
- SEO 标签:配置 `seoMeta:`;参考 references/build-seo-meta.md。
- 导出 PDF/PPTX/PNG 前,运行 `pnpm add -D playwright-chromium` 安装依赖;若导出报浏览器错误,先安装此依赖。
- 侧边编辑器:点击编辑图标;参考 references/editor-side.md。
- VS Code 扩展:安装 `antfu.slidev`;参考 references/editor-vscode.md。
- Prettier:使用 `prettier-plugin-slidev`;参考 references/editor-prettier.md。
- 弹出主题:运行 `slidev theme eject`;参考 references/tool-eject-theme.md。
- 幻灯片生命周期钩子:使用 `onSlideEnter()`、`onSlideLeave()`;参考 references/api-slide-hooks.md。
- 导航 API:使用 `$nav`、`useNav()`;参考 references/core-global-context.md。
- 使用 `cover` 布局做标题/封面幻灯片。
- 使用 `center` 布局做居中内容。
- 使用 `default` 布局做标准幻灯片。
- 使用 `two-cols` 布局做两列,并配合 `::right::`。
- 使用 `two-cols-header` 布局做标题加两列。
- 使用 `image`、`image-left`、`image-right` 布局做图片布局。
- 使用 `iframe`、`iframe-left`、`iframe-right` 布局嵌入 URL。
- 使用 `quote` 布局做引用。
- 使用 `section` 布局做章节分隔。
- 使用 `fact`、`statement` 布局展示数据/陈述。
- 使用 `intro`、`end` 布局做开头/结束幻灯片。
- 查阅文档:https://sli.dev。
- 查阅主题库:https://sli.dev/resources/theme-gallery。
- 查看展示案例:https://sli.dev/resources/showcases。
适用边界 · 注意事项
- 需要传统 PPT 原生图形化编辑、复杂时间线动画或非开发者协作流程时,Slidev 不是最合适选择。
- 没有 Node/pnpm 环境或需要完全离线开发构建时,无法直接使用 Slidev。
- 需要导出 PDF/PPTX/PNG 但无法安装 playwright-chromium 等浏览器依赖时,导出会受限。