Marp 入门指南用 Markdown 写出可直接放映的幻灯片【免费下载链接】marpThe entrance repository of Markdown presentation ecosystem项目地址: https://gitcode.com/gh_mirrors/mar/marpMarp 是一套免费的开源 Markdown 演示文稿工具你只负责写 Markdown它负责排版、分页并导出成 PDF、PPTX 或 HTML。如果你经常要做周报、课件或技术分享这篇文章会帮你在几分钟内跑通完整流程——安装、写第一份 Markdown 幻灯片、导出一份能直接放映的 PDF。Marp 适合什么时候用周会汇报把写好的 Markdown 笔记直接导出 PDF投屏就能讲不用再重做一份 PPT。团队协作导出 PPTX 后同事可以在 PowerPoint 里继续微调。在线分享导出为单个 HTML 文件丢进任何浏览器就能放映。边写边看装上 VS Code 插件敲字的同时就能看到幻灯片长什么样。快速完成第一次导出3 步第 1 步拿到代码并安装依赖。克隆仓库后安装依赖git clone https://gitcode.com/gh_mirrors/mar/marp cd marp npm install装好后你手上就有了完整的 Marp 工具链。第 2 步写一份幻灯片文件。新建一个slides.md在页面之间用---分隔这一行就是 Marp 的分页符每页写标题和要点即可。注意忘记写---是新手最常翻车的点所有页面会挤在一起。第 3 步导出 PDF。运行marp slides.md -o slides.pdf得到一份可以直接放映的文件。这里要说明导出 PDF 或 PPTX 需要本机装有 Chrome、Edge 等 Chromium 内核浏览器Marp 靠它完成页面渲染所以第一次导出会比较慢耐心等一次即可。Marp 两种编辑方式怎么选VS Code 插件还是 CLI如果你不熟悉命令行直接用 VS Code 扩展 Marp for VS Code它提供实时预览、语法提示和一键导出基本功能全覆盖。如果你习惯命令行、需要批量转换或想把幻灯片放进 CI 流水线那就选 Marp CLI。对比项Marp for VS CodeMarp CLI编辑器VS Code任意编辑器实时预览支持支持导出方式点击导出命令行自定义插件不支持支持最常见配置主题与分页怎么改改什么整份文档的外观。在 Markdown 顶部加一段 YAML front matter文件开头---与---之间的配置区写入theme: gaia这份文档就换成 gaia 主题。它只影响当前文件其他文件不受牵连。内置主题还有 default、uncover 等完整列表见 主题文档。改什么页面数量。每加一行独立的---就多一页。想合并两页就把分隔符删掉想拆页就补一行。新手常见问题排查现象全部内容挤在一页。原因页与页之间漏写了---。处理检查文件中的分页符补齐后重新导出。现象命令跑不起来或提示找不到 marp。原因依赖没装好。处理在仓库目录内执行npm install再试并确认当前目录下有slides.md。现象第一次导出 PDF 特别慢。原因后台首次拉起无头浏览器做渲染预热。处理等它完成一次后续导出会快很多。下一步看哪里主题、指令、数学公式等写作规则都收在 website/docs/guide/ 目录里写多几页后建议翻一遍。CLI 的完整参数说明在 website/docs/tools/marp-cli.md批量转换时按需查阅即可。写好第一页幻灯片剩下的交给 Marp。【免费下载链接】marpThe entrance repository of Markdown presentation ecosystem项目地址: https://gitcode.com/gh_mirrors/mar/marp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考