Marp 免费上手：5 分钟把 Markdown 转成幻灯片并导出 PDF
【免费下载链接】marpThe entrance repository of Markdown presentation ecosystem项目地址: https://gitcode.com/gh_mirrors/mar/marp
Marp 是免费的 Markdown 转幻灯片工具：你只管写 Markdown，它负责分页、排版，导出 PDF、PPTX 或 HTML，不用碰 PPT 动画。第一次做汇报的新手、想批量产幻灯片的开发者，都适合从这里开始。
5 分钟跑通第一次输出
⏱️ 只需 4 步。先说个比喻：Marp 像家餐厅，这个仓库是店面和菜单，真正炒菜的厨房是另外几个独立发布的模块，后面细讲。
git clone https://gitcode.com/gh_mirrors/mar/marp把仓库拉到本地。npm install装好依赖，3 分钟，去倒杯水。- 建一个
slides.md：
# 第一页 --- # 第二页两页之间那行---就是分页线。 4.npx marp slides.md --theme gaia -o deck.pdf第一次会慢半分钟，它在后台拉起无头浏览器，耐心等一次。跑完，你手边就有一份能直接放映的 PDF 了。
看懂项目骨架
翻开 README.md，先别急着下"这个仓库很大"的结论。它更像一家餐厅的菜单：写清了后厨有哪些模块，但灶台本身在别处。
website/ 目录是官网源码，你日常用不上。package.json 是店里的采购清单，列了依赖和脚本命令。而真正干活的转换引擎不在这个仓库里：Marpit 是基础框架，Marp Core 在它之上加好主题和常用功能，Marp CLI 才是你敲marp命令时真正调用的厨房。
所以这个仓库的定位是"入口"：读菜单、逛店面，真要动刀动锅，去对应模块的文档里找。
配置与定制：全局默认还是单文件覆盖
配置分两层，跟手机壁纸一个道理：你给手机设了全局主题，但某个 App 能单独换自己的壁纸。
- 全局默认：在运行目录放
.marprc.json，写"theme": "gaia"。以后每条命令默认走 gaia 主题，省得反复敲--theme。 - 单文件覆盖：在 Markdown 顶部加 front matter，比如
theme: default。只影响这一份文档，别的文件不受牵连。
优先级记住一句话：front matter 盖.marprc.json，命令行参数最硬。只改一次就用参数，长期用就写进配置。
发布前核对清单
⚠️ 交付前 30 秒，过一遍这 4 条：
- 现象：所有内容挤在一页。原因：忘了写
---分隔符。怎么办：每页之间补一行。 - 现象：主题不生效。原因：front matter 优先级高，盖掉了全局配置。怎么办：改 front matter，或删掉它。
- 现象：导出 PDF 直接报错。原因：系统里没有 Chromium 系浏览器。怎么办：装一个 Chrome 或 Edge。
- 现象：图片导出来显示不出来。原因：用了绝对路径或网络图片。怎么办：改成相对路径，图片放在 Markdown 旁边。
继续深入
想边写边看，装 VS Code 插件，敲字即预览。主题、指令和分页的完整规则，都收在官网 docs/ 目录里，翻两页就够上手。
【免费下载链接】marpThe entrance repository of Markdown presentation ecosystem项目地址: https://gitcode.com/gh_mirrors/mar/marp
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
