演讲者备注与注释

演讲者在台上需要提词：Slidev 允许为每张幻灯片写备注，演讲时在演讲者模式中查看，观众页面不会显示。此外还有不会被渲染的代码注释语法。

备注语法 <!-- -->

在幻灯片内容的任意位置（通常放在页尾）写入 HTML 注释，注释内容即成为该张幻灯片的演讲者备注：

# 技术架构演进

- 单体 → 微服务 → 云原生

<!--
这里写演讲者备注：
1. 先讲单体阶段的痛点
2. 再引出微服务拆分
3. 最后落到云原生趋势
-->

• 备注使用标准的 HTML 注释语法 <!-- 内容 -->
• 一条备注建议放在所属幻灯片内容的末尾
• 备注不会显示在观众看到的幻灯片上

注释与备注的区别

语法	效果	用途
<!-- 备注 -->	存入该页演讲者备注	演讲者模式中查看
<!-- 纯注释 -->（其他位置）	不渲染、不进备注	作者自己看的说明

注意：Slidev 会把每张幻灯片内的 <!-- --> 注释识别为该页备注；若只想留下不被渲染的注释（不进入演讲者备注），可放在不希望的场景下明确区分——最常用的是直接把注释当作备注使用。

打开演讲者模式

演讲者模式（Presenter Mode）是独立的浏览器窗口，显示当前页、下一页预览、备注与时间。

操作	方式
键盘快捷键	按 S 键
点击工具栏	点击底部工具栏的演讲者模式按钮

演讲者模式窗口包含：

• 当前幻灯片（大图预览）
• 下一张幻灯片（小图预览）
• 演讲者备注（当前页备注文本）
• 计时器（演讲用时）
• 绘图工具栏（可现场标注）

演示时把演讲者窗口放在副屏，主屏切换给观众即可。

备注中的 Markdown 渲染

演讲者备注支持 Markdown 渲染，可以写列表、强调、代码、链接等结构化提词：

---
layout: center
---

# 性能优化总结

<!--
### 讲点
- **背景**：QPS 从 1000 降到 200 的问题排查
- **结论**：慢 SQL + 缓存击穿是主因
- `SELECT` 加索引、热点数据预热、限流降级

参考文档：[优化案例](/docs/optimization.md)
-->

渲染效果（演讲者模式中）：

• ### 讲点 渲染为三级标题
• - **背景**：... 渲染为加粗列表
• `SELECT` 渲染为行内代码
• [优化案例](...) 渲染为链接

备注中的 HTML 渲染

备注内容同样支持 HTML，可插入图片、表格等富内容：

<!--
<table>
  <tr><th>方案</th><th>成本</th></tr>
  <tr><td>A</td><td>低</td></tr>
  <tr><td>B</td><td>高</td></tr>
</table>
-->

演讲者模式会按 HTML 语义渲染这些内容，适合放数据对照表、关键截图等。

备注使用建议

场景	备注写法
开场	写自我介绍要点与暖场话术
技术讲解	写每一屏的讲解逻辑与代码要点
演示操作	写操作步骤与可能出现的异常处理
收尾	写总结要点、联系方式、Q&A 提示

备注应简洁成点，避免照读长段落；配合演讲者模式的双屏展示，既能掌控节奏又不会忘词。