3分钟用 Markdown 做出一套专业 PPT？Marp 从零到成片的完整路径
3分钟用 Markdown 做出一套专业 PPTMarp 从零到成片的完整路径【免费下载链接】marpThe entrance repository of Markdown presentation ecosystem项目地址: https://gitcode.com/gh_mirrors/mar/marp每次做 PPT你是不是先花大量时间拖文本框、调字号而不是写内容Marp 是一个 Markdown 转 PPT 工具你只用纯文本写内容一条命令就能导出 PDF、PPTX 和 HTML 三种格式。它服务的正是想专注内容、不想被排版软件拖住时间的写作者和开发者。能力速览Marp 的 Markdown 转 PPT 能做什么一条横线换页在 Markdown 里敲---水平线它就是一页幻灯片的边界不需要任何版式操作。三种输出格式PDF 最适合现场放映任何设备都能打开PPTX 可交给同事在 PowerPoint 里继续改HTML 支持逐条展开的列表动画。主题 CSS 双管齐下内置 gaia、uncover、default 等主题一行指令切换也接受普通 CSS 微调字体、配色、背景。两种入口命令行工具 Marp CLI 适合脚本化和批量处理VS Code 扩展支持保存即预览适合不想碰终端的人。可扩展架构底层基于 markdown-it可以用插件加自定义语法进阶玩法上限很高。最小上手路径安装命令与第一次导出先确认本机装了 Node.js12 及以上版本然后执行安装npm install -g marp-team/marp-cli不想装全局命令也可以直接用 npx 跑一次不需要任何安装npx marp-team/marp-clilatest deck.md接着新建一个deck.md内容如下——顶部叫 YAML front matter文件开头用---包起来的配置区用来声明这是 Marp 文稿并指定主题--- marp: true theme: gaia --- # 你好Marp 用纯文本写内容就行。 --- # 第二页 一条 --- 水平线就是一次换页。然后一条命令导出marp deck.md --pdf想边改边看效果加上--watch --browser文件一保存浏览器里的预览就刷新。Marp CLI 左侧是转换过程右侧是导出后的 PDF 预览小贴士导出 PDF 和 PPTX 依赖 Chromium 内核浏览器Chrome 或 Edge。首次运行会自动下载对应浏览器内核稍等片刻即可。场景实操讲义页码与周报 PPTX 批量导出场景一课堂讲义。目标是出一份带页码、能随讲义发下去的 PDF。做法是在 front matter 里加两行--- marp: true theme: default paginate: true ---paginate: true让每一页右下角自动出现页码。如果你不想让封面页显示页码把paginate: true挪到第二页开头用 HTML 注释!-- paginate: true --声明即可。效果是内容只管按---分段页码、换页全部自动完成。场景二团队周报。目标是把 5 份周报 Markdown 一次性变成可编辑的 PPTX。做法就是一条循环命令for f in reports/*.md; do marp $f --pptx; done每份周报都会在同目录生成同名 .pptx 文件同事可以直接在 PowerPoint 里补图加字。如果你更习惯图形界面可以在 VS Code 里安装 Marp 扩展打开带marp: true的 Markdown 文件就能看到实时预览导出也是点按钮完成。VS Code 左侧是 Markdown 源码右侧是 Marp 实时幻灯片预览进阶玩法主题切换、CSS 样式与指令写法换主题最省事的方式是改 front matter 里的theme也可以在命令行直接用--theme uncover临时覆盖。更精细的控制靠style指令写 CSS。这里不用懂复杂理论把section想成单页幻灯片h1、p就是页上的标题和正文。--- theme: gaia style: | section { background: #f5f7fa; } h1 { color: #2c3e50; } ---另一类常用写法是局部指令即写在某页里的 HTML 注释只影响当页及后续页面!-- header: 2026 产品季度汇报 footer: 内部资料 --易错点局部指令默认会继承给后面的页面。如果只想影响当前这一页给指令名加下划线前缀如!-- _color: red --后面的页面就不会跟着变。全局指令作用于整套文稿局部指令沿页面继承常见问题新手容易踩的 3 个坑1. 页面没按预期切开检查 front matter。文件开头的第一个和第二个---被当作配置区的边界换页要从第三个---开始。另外---前如果不留空行紧跟在文字后面时会被解析成标题的下划线格式而不是换页记得保留空行。2. 列表动画在 PDF 里不见了用*星号项目符号、1)括号数字写的逐条展开列表fragmented list只在 HTML 导出时生效导出 PDF 和 PPTX 时会渲染成普通列表。要放映动画就选--html。3. 第一次导出特别慢正常现象CLI 正在自动下载 Chromium 浏览器内核。之后的导出就不会再等这一环节。现在就可以动手写一个三页的deck.md执行marp deck.md --pdf你会在目录里拿到第一份成品。想深入了解指令细节和幻灯片语法可以阅读仓库内website/docs/guide/下的文档重点是how-to-write-slides.md分页与语法、directives.md指令全表和theme.md主题定制。【免费下载链接】marpThe entrance repository of Markdown presentation ecosystem项目地址: https://gitcode.com/gh_mirrors/mar/marp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
)
