Marp 完整指南3 步把 Markdown 转幻灯片免费上手【免费下载链接】marpThe entrance repository of Markdown presentation ecosystem项目地址: https://gitcode.com/gh_mirrors/mar/marpMarp 是一个免费的 Markdown 转幻灯片工具你只管写 Markdown它负责排版、分页和导出成 PDF、PPTX 或 HTML。这篇指南写给第一次接触它的新手几分钟就能跑通你的第一次转换。它能为我做什么周会汇报写好的 Markdown 笔记直接导出 PDF投屏就能讲不用再做一份 PPT。代码分享会导出为 PPTX同事拿到后可以在 PowerPoint 里继续微调。在线分享导出成 HTML一个文件丢进任何浏览器就能放映。边写边看装上 VS Code 插件敲字的同时就能看到幻灯片长什么样。新手该看哪些核心模块路径一句话职责bin/marp命令的入口脚本你敲的命令从这里启动cli/解析命令行参数编排整个转换流程core/Markdown 转 HTML 的核心逻辑packages/marpit/Marpit 框架真正干活的渲染引擎docs/用户手册与主题、指令等技术文档package.json依赖与 scripts 命令的总配置打个比方cli是前台接单core是传菜窗口marpit才是真正开火炒菜的厨房。日常使用你只需要记住前三者。3 步完成第一次转换拿到代码git clone https://gitcode.com/gh_mirrors/mar/marp装好依赖npm install写一个用---分页的slides.md运行marp slides.md --theme gaia -o deck.pdf跑完这步你手边就有一份能直接放映的 PDF 了。两种配置方式怎么选全局默认像公司统一设置的打印机品牌局部配置像打印时临时选的纸张大小。改什么所有项目的默认值在根目录建.marprc.json写入theme: gaia。效果以后每条命令都默认用 gaia 主题不必反复加--theme。改什么只影响当前这一份文档在 Markdown 顶部加 YAML Front Matter例如theme: default。效果这份讲义换主题其余文件不受影响。记住优先级front matter 会盖掉.marprc.json只想临时改一次直接用命令行参数即可。新手常踩的坑⚠️ 三条都是高频翻车点幻灯片之间忘写---全部内容挤在同一页。以为.marprc.json生效了其实被 front matter 悄悄盖掉了。第一次导出 PDF 很慢它在后台拉起无头浏览器耐心等一次就好。接下来往哪走想深挖命令解析逻辑看 CLI 入口主题与指令的完整规则都收在 docs/ 目录里。写好第一页幻灯片剩下的交给 Marp。【免费下载链接】marpThe entrance repository of Markdown presentation ecosystem项目地址: https://gitcode.com/gh_mirrors/mar/marp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考