用 Markdown 写幻灯片有多快Marp 从入门到团队落地的完整指南【免费下载链接】marpThe entrance repository of Markdown presentation ecosystem项目地址: https://gitcode.com/gh_mirrors/mar/marp准备一次技术分享或内部培训时你是否还卡在 PowerPoint 的拖拽排版上Marp 让你直接用 Markdown 写幻灯片一个.md文件就是整份演示文稿改完一条命令就导出成 PDF。下面这份 Marp 入门教程从五分钟上手讲到团队工程化落地帮你把 Markdown 演示文稿变成真正好维护的资产。五分钟装上 Marp 并导出第一份 PDFMarp 提供两条入口任选其一即可开写Marp CLI命令行和Marp for VS Code编辑器扩展。新手最省事的是扩展路线——装好 VS Code 后从扩展市场安装 Marp for VS Code新建一个.md文件点右上角的 Marp 图标启用它会自动写入marp: true打开预览就能边写边看。如果偏爱命令行无需预先安装借npx跑一次即可npx marp-team/marp-clilatest deck.md npx marp-team/marp-clilatest deck.md --pdf一条命令生成 HTML加--pdf得到可投屏的 PDF下面是最小可用的幻灯片文件两页、带主题与页码--- marp: true theme: gaia paginate: true --- # 我的第一份幻灯片 今天聊聊 Marp 的核心玩法。 --- ## 第二页 - 用 --- 分隔每一页 - 保存即预览存为deck.md再跑一次上面的命令你就有了第一份 Markdown 幻灯片。更多写法细节可看如何编写幻灯片。三个核心能力指令、主题与导出用指令控制全局与单页Marp 通过「指令」微调幻灯片写法有两种文件顶部的 YAML front matter或任意页里的 HTML 注释。指令分两类全局指令影响整份文稿局部指令只针对当前页且默认会被后续页继承。--- theme: uncover size: 16:9 paginate: true --- !-- backgroundColor: #fffbe6 -- !-- _color: #333 --theme、size是全局指令backgroundColor、color是局部指令。给局部指令加下划线前缀如_color表示「只影响当前页不往后继承」。想看完整字段对照读指令系统说明。局部指令默认向下继承加_前缀可锁定在当前页换主题与写自定义 CSS内置default、gaia、uncover三个主题改一行theme即可切换。Marp 坚持内容与样式分离你只管写 Markdown 正文视觉交给主题 CSS。想统一品牌色用style指令或独立主题文件覆写即可无需改动正文。系统还提供 CSS 变量方便调色完整做法见主题定制指南。选对导出格式HTML、PDF、PPTX三种输出各有所长PDF跨平台一致、无网也能投屏是现场演讲的首选。HTML可部署到内网或公网支持点击逐条展开的列表等交互。PPTX导出后能塞回 PowerPoint 继续手工补页。生成 PDF 与 PPTX 依赖本机装有 Chrome、Edge 等 Chromium 系浏览器CLI 会自动调用它们完成渲染。两种工作模式编辑器实时预览 vs 命令行批处理编辑器模式Marp for VS Code写 Markdown 的同时在右侧看到成型的幻灯片带语法补全、错误诊断和一键导出。不熟悉命令行、需要即时反馈的人从这里起步最顺。左栏写 Markdown右栏同步渲染幻灯片命令行模式Marp CLI适合批量转换、管道串联、CI 自动化以及挂载 Marpit / markdown-it 插件等高级场景。日常写稿可以打开--watch监听文件变化自动重转配合--preview在预览窗口里实时核对效果。进阶玩法过渡动画与团队统一主题给 HTML 输出加上翻页过渡演示会立刻更有节奏。用局部指令transition选择内置效果marp deck.md --preview即可查看--- transition: fade --- # 带淡入淡出的页面内置不够用时可用keyframes marp-transition-名称注册自定义动画再配合view-transition-name做出元素「变形」的连贯动效。做法详见自定义过渡效果。团队协作时把公司字体、配色沉淀成一份主题 CSS约定所有演示统一theme: 你们团队的主题名。内容作者与视觉设计者各管一摊风格自然一致。工程化落地把幻灯片当代码管Git 协作幻灯片本质是.md文本直接进仓库走 diff、评审、回滚多人改动可追溯。CI 自动导出在流水线里加一步marp每次合并后自动产出最新 PDF/HTML发布即生效。并入文档站把演示页与项目文档放在同一站点下用相对路径引用一处更新两处同步。仓库自带的 docs 目录 就是一个「文档站 演示内容」共存的参考结构。常见坑与优化建议图片体积优先压缩后的横版图避免动辄几 MB 的原图拖慢首屏。字体加载自定义字体尽量用系统字体或按需加载防止布局跳动。对比度深色主题注意文字与背景的对比度兼顾可读性与可访问性。分页误判front matter 的前后两条---会被识别为元数据真正的分页要从第二条线之后开始。导出失败PDF/PPTX 报错先确认本机已装 Chromium 系浏览器。收尾Marp 把 Markdown 演示文稿变成可版本控制、可自动化的内容生产线适合写技术分享、内部培训和产品文档的团队。下一步先按上面的五分钟流程装好工具用--pdf导出你的第一份幻灯片再逐步接入团队主题与 CI。【免费下载链接】marpThe entrance repository of Markdown presentation ecosystem项目地址: https://gitcode.com/gh_mirrors/mar/marp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/11/3 10:01:13 · 阅读 1.2k 用 Markdown 写幻灯片有多快？Marp 从入门到团队落地的完整指南
用 Markdown 写幻灯片有多快Marp 从入门到团队落地的完整指南【免费下载链接】marpThe entrance repository of Markdown presentation ecosystem项目地址: https://gitcode.com/gh_mirrors/mar/marp准备一次技术分享或内部培训时你是否还卡在 PowerPoint 的拖拽排版上Marp 让你直接用 Markdown 写幻灯片一个.md文件就是整份演示文稿改完一条命令就导出成 PDF。下面这份 Marp 入门教程从五分钟上手讲到团队工程化落地帮你把 Markdown 演示文稿变成真正好维护的资产。五分钟装上 Marp 并导出第一份 PDFMarp 提供两条入口任选其一即可开写Marp CLI命令行和Marp for VS Code编辑器扩展。新手最省事的是扩展路线——装好 VS Code 后从扩展市场安装 Marp for VS Code新建一个.md文件点右上角的 Marp 图标启用它会自动写入marp: true打开预览就能边写边看。如果偏爱命令行无需预先安装借npx跑一次即可npx marp-team/marp-clilatest deck.md npx marp-team/marp-clilatest deck.md --pdf一条命令生成 HTML加--pdf得到可投屏的 PDF下面是最小可用的幻灯片文件两页、带主题与页码--- marp: true theme: gaia paginate: true --- # 我的第一份幻灯片 今天聊聊 Marp 的核心玩法。 --- ## 第二页 - 用 --- 分隔每一页 - 保存即预览存为deck.md再跑一次上面的命令你就有了第一份 Markdown 幻灯片。更多写法细节可看如何编写幻灯片。三个核心能力指令、主题与导出用指令控制全局与单页Marp 通过「指令」微调幻灯片写法有两种文件顶部的 YAML front matter或任意页里的 HTML 注释。指令分两类全局指令影响整份文稿局部指令只针对当前页且默认会被后续页继承。--- theme: uncover size: 16:9 paginate: true --- !-- backgroundColor: #fffbe6 -- !-- _color: #333 --theme、size是全局指令backgroundColor、color是局部指令。给局部指令加下划线前缀如_color表示「只影响当前页不往后继承」。想看完整字段对照读指令系统说明。局部指令默认向下继承加_前缀可锁定在当前页换主题与写自定义 CSS内置default、gaia、uncover三个主题改一行theme即可切换。Marp 坚持内容与样式分离你只管写 Markdown 正文视觉交给主题 CSS。想统一品牌色用style指令或独立主题文件覆写即可无需改动正文。系统还提供 CSS 变量方便调色完整做法见主题定制指南。选对导出格式HTML、PDF、PPTX三种输出各有所长PDF跨平台一致、无网也能投屏是现场演讲的首选。HTML可部署到内网或公网支持点击逐条展开的列表等交互。PPTX导出后能塞回 PowerPoint 继续手工补页。生成 PDF 与 PPTX 依赖本机装有 Chrome、Edge 等 Chromium 系浏览器CLI 会自动调用它们完成渲染。两种工作模式编辑器实时预览 vs 命令行批处理编辑器模式Marp for VS Code写 Markdown 的同时在右侧看到成型的幻灯片带语法补全、错误诊断和一键导出。不熟悉命令行、需要即时反馈的人从这里起步最顺。左栏写 Markdown右栏同步渲染幻灯片命令行模式Marp CLI适合批量转换、管道串联、CI 自动化以及挂载 Marpit / markdown-it 插件等高级场景。日常写稿可以打开--watch监听文件变化自动重转配合--preview在预览窗口里实时核对效果。进阶玩法过渡动画与团队统一主题给 HTML 输出加上翻页过渡演示会立刻更有节奏。用局部指令transition选择内置效果marp deck.md --preview即可查看--- transition: fade --- # 带淡入淡出的页面内置不够用时可用keyframes marp-transition-名称注册自定义动画再配合view-transition-name做出元素「变形」的连贯动效。做法详见自定义过渡效果。团队协作时把公司字体、配色沉淀成一份主题 CSS约定所有演示统一theme: 你们团队的主题名。内容作者与视觉设计者各管一摊风格自然一致。工程化落地把幻灯片当代码管Git 协作幻灯片本质是.md文本直接进仓库走 diff、评审、回滚多人改动可追溯。CI 自动导出在流水线里加一步marp每次合并后自动产出最新 PDF/HTML发布即生效。并入文档站把演示页与项目文档放在同一站点下用相对路径引用一处更新两处同步。仓库自带的 docs 目录 就是一个「文档站 演示内容」共存的参考结构。常见坑与优化建议图片体积优先压缩后的横版图避免动辄几 MB 的原图拖慢首屏。字体加载自定义字体尽量用系统字体或按需加载防止布局跳动。对比度深色主题注意文字与背景的对比度兼顾可读性与可访问性。分页误判front matter 的前后两条---会被识别为元数据真正的分页要从第二条线之后开始。导出失败PDF/PPTX 报错先确认本机已装 Chromium 系浏览器。收尾Marp 把 Markdown 演示文稿变成可版本控制、可自动化的内容生产线适合写技术分享、内部培训和产品文档的团队。下一步先按上面的五分钟流程装好工具用--pdf导出你的第一份幻灯片再逐步接入团队主题与 CI。【免费下载链接】marpThe entrance repository of Markdown presentation ecosystem项目地址: https://gitcode.com/gh_mirrors/mar/marp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考