一个 Markdown 文件做出幻灯片Marp for VS Code 安装、预览与导出指南【免费下载链接】marpThe entrance repository of Markdown presentation ecosystem项目地址: https://gitcode.com/gh_mirrors/mar/marpMarp 是一套基于 Markdown 的演示文稿工具Marp for VS Code 是它的官方 VS Code 插件把普通的 Markdown 预览变成可以放映的幻灯片。它适合经常在 VS Code 里写文档、又想少切几个窗口做技术分享或答辩演示的你写文本、看效果、导出成品都在同一个窗口完成。三分钟跑通装好插件并打开实时预览三种安装方式扩展市场按CtrlShiftXMac 为CmdShiftX打开扩展面板搜索Marp for VS Code点安装等它激活即可。命令行code --install-extension marp-team.marp-vscode源码开发版git clone https://gitcode.com/gh_mirrors/mar/marp cd marp npm install npm run build code --install-extension ./packages/marp-vscode/*.vsix装好后打开设置Ctrl,/Cmd,先确认几个常用项markdown.marp.theme默认主题可选default/gaia/uncover、markdown.marp.enableHtml是否允许 HTML 标签、markdown.marp.exportType默认导出格式。这几项不改也能用知道在哪改即可。打开实时预览看到第一张幻灯片新建一个.md文件在开头写入 front-matter--- marp: true --- # 第一张幻灯片 正文写在这里marp: true是开关告诉 VS Code 这个文件按 Marp 处理。接着按CtrlK VMacCmdK V打开分屏预览左边打字、右边翻页改动会立刻反映到幻灯片上 。为什么值得换指令系统、Markdown 即幻灯片与双向同步Marp 把写 Markdown和做幻灯片合成同一件事省掉了编辑器与 PPT 软件之间的来回切换。旧流程用 Marp 之后编辑器和演示软件来回切一个 VS Code 窗口搞定手动调格式、排样式Markdown 语法自动排版纯文本难留痕改一版git diff就能看到差异Markdown 即幻灯片你熟悉的 Markdown 直接就是幻灯片#标题当页面主题---分隔线就是换页代码块、表格、图片照常可用。周会做技术分享一个.md文件把代码示例写完就能导出论文答辩时纯文本便于修改和留版本改动一目了然。指令系统自动补全与诊断Marp 用指令控制主题、页码、页眉页脚写在 front-matter 或 HTML 注释里!-- theme: uncover paginate: true footer: 论文答辩 --插件对指令有完整的智能支持 在指令区按CtrlSpace触发自动补全光标悬停显示该指令的说明拼错的指令名、写错的theme值会直接进问题面板报警不用再靠肉眼排查。双向同步编辑区与预览区滚动位置自动对齐预览可缩放深浅色跟随 VS Code 主题切换。你改到哪一页右边就翻到哪一页不用手动刷新。导出与发布一键输出 PDF、HTML、PPTX 和图片从命令面板导出命令面板CtrlShiftP/CmdShiftP运行Marp: Export Slide Deck即可导出下列格式点一下就有不用记命令格式适合场景PDF正式放映与打印HTML网页分享、在线演示PPTX交给同事用 PowerPoint 继续编辑PNG / JPEG单页截图常用导出参数要更细的控制就用 Marp CLI# 自定义主题、加页码与备注导出 PDF marp --theme custom.css --pdf --slide-number --notes deck.md # 压缩输出体积 marp --pdf --compress deck.md没装全局命令时可用npx marp-team/marp-clilatest deck.md直接跑一次。进阶与避坑自定义主题、工作区信任、Git 协作与常见问题自定义主题写一个custom-theme.css用 CSS 覆盖颜色、标题、代码块样式然后在设置里挂上markdown.marp.themes: [./custom-theme.css]工作区信任未受信任的工作区会被限制导出命令、工作区自定义主题markdown.marp.themes、HTML 标签markdown.marp.enableHtml都不生效只保留基础预览与指令支持。需要这些功能时通过文件 管理工作区信任把当前目录设为可信。Git 协作幻灯片是纯文本天然好做版本管理git diff差异清晰、可并行编辑、历史完整配合 Pull Request 评审流程很顺。常见问题速查现象可能原因处理预览卡顿页数过多拆成多个文件导出 PDF 失败资源路径解析不到加--allow-local-files主题不生效路径写错用绝对路径或工作区相对路径后续规划团队还在推进的有带幻灯片缩略图的侧边栏、右下角播放按钮、基于 Live Share 的多人协作等让从其他工具迁移更顺。更多细节可以看 Marp for VS Code 文档、Marp 指令参考 与 安装指南。【免费下载链接】marpThe entrance repository of Markdown presentation ecosystem项目地址: https://gitcode.com/gh_mirrors/mar/marp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考