Marp 免费把 Markdown 转幻灯片：一条命令导出 PDF 的新手指南
【免费下载链接】marpThe entrance repository of Markdown presentation ecosystem项目地址: https://gitcode.com/gh_mirrors/mar/marp
Marp 是开源的 Markdown 转幻灯片工具：你写 Markdown，它自动分页排版，导出 PDF、PPTX、HTML。这份指南带你跑通第一条转换命令。
什么场景下用 Markdown 转幻灯片
周会要讲内容时，把写好的 Markdown 笔记直接转成 PDF，投屏就能讲，不用再单独做一份 PPT。
分享结束想让别人继续改，就导出 PPTX。同事在 PowerPoint 里直接微调，你的 Markdown 源稿原样保留。
边写边看就用 VS Code 插件。敲字的同时右侧就是幻灯片预览，改一行看一行。
3 条命令跑通第一次导出
git clone https://gitcode.com/gh_mirrors/mar/marp cd marp && npm install第一条拉取项目源码，第二条进入目录并装好运行依赖。
再写一个slides.md，页与页之间用---分隔，然后执行：
npx marp slides.md --theme gaia -o deck.pdf这条命令按 gaia 主题渲染并落成 PDF。跑完，手边就有一份能直接放映的 deck.pdf。
一条流水线看懂内部结构
你写的 Markdown 先进@marp-team/marp-cli解析参数，再交给@marp-team/marp-core转成带主题的幻灯片 HTML，最后由@marp-team/marpit落盘成 PDF 或 HTML。本仓库是生态入口，website/放的是文档站点。
可以这样理解：整条线像一条自动传送带，你在起点放上原料，分拣、加工、打包全自动完成，终点直接取成品。
全局与文件级配置的优先级规则
全局默认写在.marprc.json，比如"theme": "gaia"，每条命令默认都生效。文件级默认写在每份 Markdown 顶部的 front matter，只影响这一份文档。
两者冲突时，front matter 盖过全局配置；只想临时改一次，直接在命令行加--theme参数。
一句话：90% 的情况你只需要改文档顶部的 front matter 一处。
容易卡住的三个点
⚠️ 三个高频问题，先记一下。
内容全挤在一页：原因是漏写了---分页线。补上再导出即可。
改了全局配置却不生效：多半是这份文档顶部有 front matter 把值盖掉了。先看文档开头几行。
第一次导出 PDF 特别慢：后台在首次拉起无头浏览器，属一次性开销。等它跑完这一次就好。
想继续深入
命令解析从@marp-team/marp-cli的入口读起，主题与指令的完整规则都在website/docs/里。
【免费下载链接】marpThe entrance repository of Markdown presentation ecosystem项目地址: https://gitcode.com/gh_mirrors/mar/marp
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
