VS Code

该扩展是 go-slides 版的 Marp for VS Code：演示文稿会在 VS Code 的 Markdown 预览中以幻灯片形式显示，错误会显示在“问题”面板中， 指令、kind（幻灯片类型）和模板函数会在输入时自动补全。

安装

从 releases 页面下载 go-slides-<version>.vsix，然后运行 Extensions: Install from VSIX…，或者：

code --install-extension go-slides-0.4.0.vsix

预览不需要任何其他依赖。导出则需要 slides 命令：

go install github.com/go-slides/slides/cmd/slides@latest

预览

打开一个演示文稿，然后执行 Markdown: Open Preview to the Side。演示文稿就是 front matter 中写有 slides: true 的 Markdown 文件：

---
slides: true
paginate: true
data:
  who: World
---

# Hello {{ .who }}

---

<!-- _kind: title -->
# Page {{ page }} of {{ total }}

带有 marp: true 的文件也会被预览，除非已安装 Marp for VS Code： 因为那样两个扩展会渲染同一个文档。由设置项 goSlides.preview.marpDocuments 决定：auto（默认）、always 或 never。

预览就是 go-slides 本身，编译为 WebAssembly 并由扩展加载：不需要二进制文件， 在 vscode.dev 上也能使用。它从工作区中读取演示文稿用到的内容 （演示文稿旁边的 slides.yaml 或 slides.hcl、其中引用的 kind 文件、 模板引入的文件、主题 CSS），且只从演示文稿所在的工作区文件夹中读取。

滚动同步

从扩展 v0.2.0（go-slides v0.7.0）起，编辑器与预览会双向同步滚动， 与普通 Markdown 一样：预览跟随编辑器光标所在的幻灯片和块， 滚动预览也会移动编辑器。相关设置是 VS Code 自带的 markdown.preview.scrollPreviewWithEditor 和 markdown.preview.scrollEditorWithPreview。

行号映射会穿过模板。由 {{ range }} 生成的幻灯片跟随其模板所在的行， 由 {{ include }} 引入的内容跟随 include 所在的行。用 headingDivider 拆分的演示文稿 按其标题同步。

演示

从扩展 v0.4.0（go-slides v0.9.0）起，无需离开 VS Code 即可进行演示。 在编辑器中打开演示文稿后，从命令面板或编辑器的 … 菜单中选择：

这些面板位于编辑器旁边，并相互同步：在其中一个面板中切换幻灯片，其他面板也会随之切换。 它们也会跟随你对演示文稿的编辑。在幻灯片中按 p 键会打开演讲者视图。

要在另一块屏幕上演示，请用 View: Move Editor into New Window 把幻灯片面板移过去。

每个面板都在一个沙盒框架（不带 allow-same-origin）中运行演示文稿，并采用 default-src 'none' 策略：框架只加载图片、媒体、样式和字体， 且只运行 go-slides 内置于页面、按哈希值指定的脚本。演示文稿自己写的脚本不会运行。

问题提示、自动补全与悬停提示

• 问题：模板、YAML 和 HCL 错误，显示在出错的行上， 位于演示文稿中或其来源的 kind 文件中。
• 自动补全：front matter 中和 <!-- --> 注释中的指令键 （单页指令带 _），kind 和 _kind 的取值（附带每个 kind 设置的内容）， theme、size、paginate、math、headingDivider；在 {{ }} 内则补全模板函数和数据字段。
• 悬停提示：指令的作用、kind 设置的内容、模板函数的参数。

导出

go-slides: Export Slide Deck…（也位于编辑器标题栏中）会调用 slides 命令写出 HTML、 矢量 PDF、可编辑的 PPTX 和 ODP、PNG 或 JPEG，效果与 slides -o deck.pdf deck.md 相同；参见命令行。 导出需要受信任的工作区。如果找不到 slides，扩展会提议在终端中运行上面的 go install。

设置

安全

演示文稿和工作区都被视为不可信。原始 HTML 遵循 Marp 的白名单， 除非在受信任的工作区中开启了 goSlides.html（在 slides.yaml 中设置 html: true 不会在预览中开启它），而且 VS Code 的预览不会运行演示文稿中的任何脚本。 预览只读取演示文稿所在工作区文件夹中的文件，不跟随符号链接，模板也看不到任何环境变量。 导出会运行一个程序，因此要等工作区被信任后才会进行，而且该程序永远不会由工作区指定。

性能

在 go-slides 的 100 张幻灯片基准演示文稿上，使用 Apple M4 Max 上的 VS Code 1.142， 并在同一会话中测量 Marp for VS Code 3.6.1：

以上数据针对扩展 v0.3.0（go-slides v0.8.0），使用 100 张幻灯片的演示文稿， 在第 50 张幻灯片中输入一个字符，在 1 分钟负载低于 8 的条件下交错多轮测得。 首次预览比 Marp 快，现在编辑后的预览也比 Marp 快。

v0.8.0 与扩展 v0.3.0

go-slides v0.8.0 会保留每个已打开演示文稿的渲染结果，编辑后只重新渲染 源码或继承状态（指令、页码、总页数、标题 id、链接引用、源码行）发生变化的幻灯片； 输出与完整渲染逐字节相同。在 100 张幻灯片中的第 50 张中输入，只会重新渲染一张幻灯片： 原生 2.5 ms，WebAssembly 中 11.5 ms。随后 VS Code 的预览只对变化幻灯片的 DOM 做差量更新； 扩展的冒烟测试会对两个扩展都在两次计时渲染之间向第 50 张幻灯片输入一个字符。 扩展的演讲者视图通过父窗口（postMessage）同步。

v0.7.1 与扩展 v0.2.2

go-slides v0.7.1 会在多次渲染之间缓存已解析的主题、打包好的样式表和已高亮的代码， 标记滚动同步行时不再逐字节处理，并复用其写入器：渲染 100 张幻灯片的演示文稿需分配 5.7 MB 内存， 扩展 v0.2.0 时为 52.7 MB。借此，扩展 v0.2.2 去掉了 GOGC=400 覆盖设置。 作为对比，扩展 v0.2.1 在默认 GOGC 下首次预览耗时 72 ms，编辑后 44 ms （使用 GOGC=400 时为 36 ms），而 v0.2.0 为 47–51 ms。

扩展 v0.2.2 测得首次预览 52 ms、编辑后 24 ms， 与 Marp 的 23 ms 持平。