<p>Marp for VS Code是VSCode中唯一原生支持实时预览、主题切换及PDF/HTML导出的Markdown幻灯片方案；需认准marp-team官方扩展、严格配置YAML头（--- marp: true ---）、用---分页，并通过拖入图片或同目录相对路径插入图片。</p>
Marp for VS Code 插件不是“可选工具”，而是当前 VSCode 生态中唯一能原生支持实时预览、主题切换、PDF/HTML 导出且无需额外服务的 Markdown 幻灯片方案。装错扩展、漏配 YAML 头、误用分页符，是 90% 新手卡住的三处硬伤。
成品ppt在线生成，百种模板可供选择☜☜☜☜☜点击使用；
怎么确认装对了 Marp for VS Code？
VSCode 扩展市场里搜 “Marp” 会出现多个结果，但只有作者是 marp-team（不是 yzane，那是旧版）、图标为蓝白渐变圆环、名称精确匹配 Marp for VS Code 的才是正确版本。安装后，打开任意 .md 文件，编辑器右上角应立刻出现一个双三角形图标（▶▶），点击它会弹出 “Toggle Marp Feature” 菜单——这个图标不出现，说明插件没生效或被其他 Markdown 插件拦截。
常见错误现象：
- 装了 “Marp CLI” 或 “Marp App” 相关扩展：这些是命令行工具或独立桌面应用，和 VSCode 无关
- 装了 “Markdown Preview Enhanced”：它会抢占
.md预览逻辑，导致 Marp 图标不显示 - 插件已安装但未启用：重启 VSCode 后再检查
--- marp: true --- 必须写在文件最开头，且不能有空行
这是 Marp 解析幻灯片的开关信号，不是可选注释。如果写成：
```markdown
# 我的标题
<hr /><h2>marp: true</h2><pre class='brush:</pre>;toolbar:false;'>
<p>——Marp 完全不会识别。必须严格满足：</p>
<ul>
<li>文件第一行就是 <code>---</code></li>
<li>第二行是 <code>marp: true</code>（可加 <code>theme</code>、<code>paginate</code> 等字段）</li>
<li>第三行是 <code>---</code></li>
<li>第四行开始才是内容，中间不能插入空行或注释</li>
</ul>
<p>参数差异影响很大：<code>headingDivider: 2</code> 表示所有 <code>##</code> 标题自动分页；<code>headingDivider: [2,3]</code> 则 <code>##</code> 和 <code>###</code> 都分页；不写该字段时，仅靠 <code>---</code> 分页。</p>
<H3>图片插入失败？本地路径和尺寸控制是关键</H3>
<p>直接写 <code></code> 在预览中大概率显示为红叉，因为 Marp 默认不读取本地文件系统路径。解决方式只有两个：</p>
<ul>
<li>把图片拖进 VSCode 编辑器，它会自动复制到当前文件夹并生成相对路径（推荐）</li>
<li>手动确保图片与 <code>.md</code> 文件在同一目录下，且路径为 <code></code>（无点斜杠）</li>
</ul>
<p>图片默认撑满宽度，遮挡文字。必须显式限制尺寸：</p>
<pre>```markdown
{ width=300 }
<!-- 或 -->
<img src="logo.png" width="300" />
```</pre>
<p>注意：<code>{ width=300 }</code> 是 Marp 支持的 inline HTML 扩展语法，不是标准 Markdown，也不支持 <code>w:300</code> 这种写法。</p>
<H3>导出 PDF 失败？别碰 <code>export as pptx</code></H3>
<p>Marp 原生只支持导出 <code>PDF</code> 和 <code>HTML</code>，根本不提供 <code>PPTX</code> 功能。所谓“导出失败”，八成是点了错误菜单：</p>
<ul>
<li>正确路径：<code>Ctrl+Shift+P</code> → 输入 <code>Marp: Export as PDF</code> → 回车</li>
<li>错误操作：在右键菜单里找 “Export as pptx” 或安装第三方转换插件</li>
<li>导出卡住常见原因：PDF 导出依赖系统内置的 Chromium 渲染引擎，若 VSCode 以管理员模式运行，而 Chromium 没权限访问临时目录，就会静默失败</li>
</ul>
<p>真正容易被忽略的是：导出前务必关闭所有其他 Marp 预览窗口（尤其是多个标签页同时开着预览），否则 PDF 可能混入上一页的样式或页眉。</p> 
