Marp 完整教程用 Markdown 写一套可导出 PDF 的幻灯片三步搞定【免费下载链接】marpThe entrance repository of Markdown presentation ecosystem项目地址: https://gitcode.com/gh_mirrors/mar/marp上午九点的例会前你发现要分享的材料还躺在一个半年没打开过的 PPT 里改个字号、挪个文本框、贴张图第三页就卡住了。这种痛有个解法值得记住Marp。它让你用纯 Markdown 写幻灯片一条命令导出 PDF、PPTX 或 HTML一套材料就是一个文本文件。如果你是需要频繁做技术分享的开发者或者想把演示文稿和代码放在一起做版本管理这篇教程就是写给你的。 先跑起来三步写出你的第一套幻灯片第 1 步写一个deck.md文件--- theme: gaia paginate: true --- # 你好Marp 第一页标题加一行正文 --- # 第二页 - 用 --- 分隔一行一条横线就是一页白话解释开头三行叫 front matterYAML 前置元数据它是整套幻灯片的开关面板theme: gaia选一个内置主题paginate: true打开页码。正文里每敲一行---就翻到新的一页。第 2 步一条命令转换npx marp-team/marp-clilatest deck.md白话解释npx会临时下载并运行 Marp CLIMarp 家族的命令行转换器不用先安装。常用的人可以用brew install marp-climacOS或scoop install marpWindows装成固定命令。第 3 步看结果同目录下会多出一个deck.pdf。打开它两页文字已经变成排版整齐的幻灯片——这就是成了的反馈。 为什么选 Marp三个最实在的卖点卖点一幻灯片文件本身就是文本你的演示文稿是仓库里的一个.mdGit 能逐行 diff、能git blame。例同事把版本号从 2.1 改成 2.2代码评审怎么查幻灯片评审就怎么查。卖点二一份源文件多种格式一致渲染同一个文件可以导出 PDF、PPTX、HTML 和图片各格式间的分页、字体、版式保持一致。例线下观众发 PDF内网同事挂 HTML 在线翻页互不返工。卖点三外观全交给 CSS内容全是文本主题就是一组 CSS 文件内容与设计彻底分离。例把 front matter 里的theme: gaia换成gauge或uncover整套配色立刻换掉正文一个字不动。 指令详解front matter 就是幻灯片的 EXIF 信息front matter 里那些键值对有个正式名字——指令directives它不承载内容只决定内容怎么显示。分两种全局指令theme、size、math、title等对整套幻灯片生效局部指令paginate、header、footer、背景色等从写它的那一页开始生效后面的页面会默认继承前页的设置。!-- paginate: true _backgroundColor: #102a43 -- # 这一页深藏蓝白话解释注释里写指令和写在 front matter 等价指令名前面的下划线_表示只对当前页生效去掉下划线后续页就会继承这个背景色。细节坑不少比如页眉页脚中途重置、标题页跳过页码完整清单见指令参考。 进阶玩法主题定制、转场动画与工具组合微调与定制主题正文里直接插一个style标签就能覆盖主题样式或者干脆写一个独立的主题 CSS 文件。会一点 CSS 就能上手入门路径见主题指南。转场动画导出 HTML 后页面之间可以加切换动画甚至手写自定义转场。官方博客有一篇手把手教程如何制作自定义转场。配合 VS Code 使用装上 Marp for VS Code 扩展后Markdown 预览就是实时幻灯片还有指令补全比纯 CLI 更省心。批处理与自动化因为入口是命令行批量导出、挂到 CI 里生成幻灯片 PDF 都是顺手的for f in slides/*.md; do npx marp $f; done白话解释遍历slides目录下所有 Markdown逐个转成 PDF一条循环脚本搞定整季度汇报材料。语法层面的小扩展也值得知道把无序列表的-写成*就变成分块列表逐条浮现仅 HTML 导出生效详见分块列表front matter 里加math: katex即可排版数学公式详见数学公式图片支持尺寸、位置属性见图片语法。⚖️ 同类对比Marp、Slidev、reveal.js 怎么选reveal.jsHTML 幻灯片的老将插件生态厚、动画能力强代价是必须写 HTML/JS学习成本高。Slidev基于 Vue交互天花板高能嵌 Vue 组件、Three.js但需要 Node 环境和一定前端功底。Marp纯 Markdown、零代码把内容快速变成幻灯片这条路上门槛最低。一句话结论要交互和动画选 Slidev 或 reveal.js要速度和可版本管理的文本选 Marp。 选型判断Marp 适合谁、不适合谁适合你如果内容主体是文字、代码块和图表版式用标准模板就能承载——技术分享、课件、内部汇报团队希望演示文稿进 Git走 PR 评审流程想把生成幻灯片 PDF做成 CI 里的自动化步骤。不适合你如果需要大量动画、实时图表、测验互动页——去 Slidev 或 reveal.js坚持拖拽式图形编辑、不接受 Markdown 语法——留在 PowerPoint需要自由摆位的复杂自定义版式——Marp 是线性单栏模板思路摆不出随意排布的元素。 下一步Marp 把做幻灯片这件事还原成了写文档。从安装指南和幻灯片写法入门开始仓库入口在README文档总目录里还有更多章节。建议的行动今晚就写一个三页的deck.md用npx marp-team/marp-clilatest转一次 PDF——明早的会它就能替你的 PPT 出工。【免费下载链接】marpThe entrance repository of Markdown presentation ecosystem项目地址: https://gitcode.com/gh_mirrors/mar/marp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/11/5 4:26:02 · 阅读 1.2k Marp 完整教程：用 Markdown 写一套可导出 PDF 的幻灯片，三步搞定
Marp 完整教程用 Markdown 写一套可导出 PDF 的幻灯片三步搞定【免费下载链接】marpThe entrance repository of Markdown presentation ecosystem项目地址: https://gitcode.com/gh_mirrors/mar/marp上午九点的例会前你发现要分享的材料还躺在一个半年没打开过的 PPT 里改个字号、挪个文本框、贴张图第三页就卡住了。这种痛有个解法值得记住Marp。它让你用纯 Markdown 写幻灯片一条命令导出 PDF、PPTX 或 HTML一套材料就是一个文本文件。如果你是需要频繁做技术分享的开发者或者想把演示文稿和代码放在一起做版本管理这篇教程就是写给你的。 先跑起来三步写出你的第一套幻灯片第 1 步写一个deck.md文件--- theme: gaia paginate: true --- # 你好Marp 第一页标题加一行正文 --- # 第二页 - 用 --- 分隔一行一条横线就是一页白话解释开头三行叫 front matterYAML 前置元数据它是整套幻灯片的开关面板theme: gaia选一个内置主题paginate: true打开页码。正文里每敲一行---就翻到新的一页。第 2 步一条命令转换npx marp-team/marp-clilatest deck.md白话解释npx会临时下载并运行 Marp CLIMarp 家族的命令行转换器不用先安装。常用的人可以用brew install marp-climacOS或scoop install marpWindows装成固定命令。第 3 步看结果同目录下会多出一个deck.pdf。打开它两页文字已经变成排版整齐的幻灯片——这就是成了的反馈。 为什么选 Marp三个最实在的卖点卖点一幻灯片文件本身就是文本你的演示文稿是仓库里的一个.mdGit 能逐行 diff、能git blame。例同事把版本号从 2.1 改成 2.2代码评审怎么查幻灯片评审就怎么查。卖点二一份源文件多种格式一致渲染同一个文件可以导出 PDF、PPTX、HTML 和图片各格式间的分页、字体、版式保持一致。例线下观众发 PDF内网同事挂 HTML 在线翻页互不返工。卖点三外观全交给 CSS内容全是文本主题就是一组 CSS 文件内容与设计彻底分离。例把 front matter 里的theme: gaia换成gauge或uncover整套配色立刻换掉正文一个字不动。 指令详解front matter 就是幻灯片的 EXIF 信息front matter 里那些键值对有个正式名字——指令directives它不承载内容只决定内容怎么显示。分两种全局指令theme、size、math、title等对整套幻灯片生效局部指令paginate、header、footer、背景色等从写它的那一页开始生效后面的页面会默认继承前页的设置。!-- paginate: true _backgroundColor: #102a43 -- # 这一页深藏蓝白话解释注释里写指令和写在 front matter 等价指令名前面的下划线_表示只对当前页生效去掉下划线后续页就会继承这个背景色。细节坑不少比如页眉页脚中途重置、标题页跳过页码完整清单见指令参考。 进阶玩法主题定制、转场动画与工具组合微调与定制主题正文里直接插一个style标签就能覆盖主题样式或者干脆写一个独立的主题 CSS 文件。会一点 CSS 就能上手入门路径见主题指南。转场动画导出 HTML 后页面之间可以加切换动画甚至手写自定义转场。官方博客有一篇手把手教程如何制作自定义转场。配合 VS Code 使用装上 Marp for VS Code 扩展后Markdown 预览就是实时幻灯片还有指令补全比纯 CLI 更省心。批处理与自动化因为入口是命令行批量导出、挂到 CI 里生成幻灯片 PDF 都是顺手的for f in slides/*.md; do npx marp $f; done白话解释遍历slides目录下所有 Markdown逐个转成 PDF一条循环脚本搞定整季度汇报材料。语法层面的小扩展也值得知道把无序列表的-写成*就变成分块列表逐条浮现仅 HTML 导出生效详见分块列表front matter 里加math: katex即可排版数学公式详见数学公式图片支持尺寸、位置属性见图片语法。⚖️ 同类对比Marp、Slidev、reveal.js 怎么选reveal.jsHTML 幻灯片的老将插件生态厚、动画能力强代价是必须写 HTML/JS学习成本高。Slidev基于 Vue交互天花板高能嵌 Vue 组件、Three.js但需要 Node 环境和一定前端功底。Marp纯 Markdown、零代码把内容快速变成幻灯片这条路上门槛最低。一句话结论要交互和动画选 Slidev 或 reveal.js要速度和可版本管理的文本选 Marp。 选型判断Marp 适合谁、不适合谁适合你如果内容主体是文字、代码块和图表版式用标准模板就能承载——技术分享、课件、内部汇报团队希望演示文稿进 Git走 PR 评审流程想把生成幻灯片 PDF做成 CI 里的自动化步骤。不适合你如果需要大量动画、实时图表、测验互动页——去 Slidev 或 reveal.js坚持拖拽式图形编辑、不接受 Markdown 语法——留在 PowerPoint需要自由摆位的复杂自定义版式——Marp 是线性单栏模板思路摆不出随意排布的元素。 下一步Marp 把做幻灯片这件事还原成了写文档。从安装指南和幻灯片写法入门开始仓库入口在README文档总目录里还有更多章节。建议的行动今晚就写一个三页的deck.md用npx marp-team/marp-clilatest转一次 PDF——明早的会它就能替你的 PPT 出工。【免费下载链接】marpThe entrance repository of Markdown presentation ecosystem项目地址: https://gitcode.com/gh_mirrors/mar/marp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考