marp for vs code 是唯一支持代码块全屏+幻灯片转场的插件，需满足首行---、次行marp: true、第三行---三条件才生效，且推荐用---分页而非##，导出首选html或浏览器打印pdf。
Marp for VS Code 是唯一能直接在 VSCode 里实现「代码块全屏展示 + 幻灯片转场」的插件，其他 Markdown 预览插件（如 Markdown Preview Enhanced）不支持分页、主题、代码高亮联动和导出为幻灯片格式。
AI一键生成成品PPT☜☜☜☜☜点击生成；
怎么确认 Marp 插件已真正识别当前文件为幻灯片
VSCode 不会自动把任意 .md 文件当幻灯片处理，必须满足三个硬性条件：
-
---必须是文件第一行，不能有空行、BOM 字符或注释 - 第二行必须是
marp: true（注意是英文冒号、小写 true、无引号） - 第三行必须是
---，之后才能写内容 - 右上角出现 ▶▶ 图标且点击后菜单含
Toggle Marp Feature才算生效 - 如果装了
Markdown Preview Enhanced，它大概率会拦截预览逻辑——直接卸载或禁用其预览功能
代码块要全屏展示且保持高亮，关键在 YAML 和语法标记
默认情况下，长代码块会被截断或强制换行，根本原因不是 Prism.js 失效，而是 CSS 白空间策略没覆盖到。必须同时满足：
- YAML 头里显式声明语言：例如
```python，不能只写``` - 在 YAML 区块中加入
html: true和math: true，否则部分主题下代码块被当纯文本渲染 - 用
style: |写内联 CSS 控制溢出：style: | pre code { white-space: pre; } .marp-slides pre { overflow-x: auto; } - 避免在代码块中混用中文全角空格、制表符或不可见 Unicode 字符——Marp 解析器对这类字符极敏感
为什么用 --- 分页比用 ## 更可靠
很多人想靠标题自动分页，但 headingDivider 参数极易被忽略或误配。实际使用中，--- 是唯一零配置、行为确定的分页方式：
-
---出现即切页，不依赖任何 YAML 设置，也不受后续标题层级干扰 -
##分页需配合headingDivider: 2，且一旦文件里先用了---，Marp 会锁定「手动分页模式」，后面所有##都失效 - 混合使用
---和##是最常见翻车点：比如前 5 页用##，第 6 页插入一个---做过渡页，结果从第 7 页起##全部不触发分页 - 导出 PDF 或 HTML 时，
---分页的渲染一致性远高于标题驱动分页
导出 PPTX 的真实限制和替代路径
Marp 的 PPTX 导出本质是 marp-cli 调用 Chromium 渲染 HTML 后转 Office 格式，不是原生支持。你遇到的问题几乎都源于此：
- 代码块变纯文本？因为 Prism.js 高亮依赖 JS 运行时，PPTX 不执行脚本
- 数学公式乱码？KaTeX 渲染结果未转为图片就导出，Office 无法解析 LaTeX
- 本地图片路径失效？即使开了
allowLocalFiles: true，PPTX 导出链不读取该配置 - 真正可用的交付物只有两种：
Marp: Export slide deck → HTML（带翻页动画、可点击代码块），或浏览器打印为 PDF（字体、样式、布局可控）
最容易被忽略的是：导出前必须先完整打开预览窗口并滚动到底部，让所有页面完成异步资源加载——否则导出引擎拿到的是未渲染完的 DOM。
