Marp 快速上手指南3 步在本地把 Markdown 变成免费可导出的幻灯片【免费下载链接】marpThe entrance repository of Markdown presentation ecosystem项目地址: https://gitcode.com/gh_mirrors/mar/marpMarpMarkdown Presentation Ecosystem是一套免费的 Markdown 幻灯片生态你只管用纯 Markdown 写字它负责分页、套主题、排版并导出成 PDF、PPTX 或 HTML。这篇文章写给第一次接触 Marp 的人读完你不仅能 3 步在本地把官方站点跑起来还能照着完整工作流出自己第一份可放映的幻灯片。它替你省掉的 3 件事省掉排版以前在 PowerPoint 里拖文本框、对字号、等版式对齐现在一份 Markdown 文件里用---分页标题、列表、表格写出来就是成型的页面。省掉多份维护同一份 Markdown 能导出成 PDF、PPTX、HTML 三种格式渲染结果保持一致——汇报投屏用 PDF、同事接手用 PPTX、线上传播用 HTML不用为每个场合重做一遍。✍️省掉学习成本语法基于 CommonMark你已会的 Markdown 基本都能直接用Marp 只在此基础上加了分页、指令、主题这几样扩展门槛极低。3 步跑通本地 Marp 官网环境仓库是 Marp 生态的入口仓库官网和用户手册就放在里面的 website/ 目录下跑起来后可以直接浏览文档、看预览示例。拉取代码运行git clone https://gitcode.com/gh_mirrors/mar/marp然后进入marp目录。预期结果本地出现一份完整仓库含README.md、package.json和website/。安装依赖运行yarn install。仓库自带yarn.lock用它锁定版本最稳。预期结果依赖安装完成无致命报错。启动站点运行yarn website。预期结果本地开发服务器启动终端提示编译完成。跑完这步在浏览器打开 http://localhost:3000 你看到的就是完整的 Marp 官方网站Markdown 转幻灯片的实时预览示例、安装教程、指令参考、主题说明等导航一应俱全。4 种用途对应的能力版图用途触发方式产出 写作时实时看效果在 VS Code 装 Marp 扩展打开.md文件编辑器侧边即时渲染的幻灯片预览 在线放映Marp CLI 转换命令单个 HTML 文件浏览器打开即放映 投屏汇报Marp CLI 的--pdf导出可直接放映的 PDF 文件 交给同事用 PowerPoint 改Marp CLI 的--pptx导出可在 PowerPoint 中继续编辑的 PPTX 文件一次完整工作流把周会笔记变成 3 页幻灯片以「周会汇报」这个真实场景走一遍你手里只有一个写满要点的notes.md第 1 步加信封。在文件顶部写入 YAML front matter——marp: true声明这是幻灯片文件theme指定主题。这相当于告诉转换器这份文件要按幻灯片处理长这个样子。第 2 步按页切分。把笔记按「一页讲一件事」拆开每两页之间空一行后写一行---分隔线。写完的文件在 VS Code 里打开预览就能逐页检查分页是否符合预期。第 3 步按需微调。想显示页码加一行paginate: true想让大标题页自动分节加一行headingDivider: true。这些指令都写在文档的 指令参考 里随时可查。第 4 步导出交付。用 Marp CLI 把文件转成 PDF 投屏如果同事要接着改再导一份 PPTX 发过去。从写起到交稿你自始至终只写过一份 Markdown。理解生态分工一家餐厅的四层结构Marp 家族分散在多个仓库里各自维护这个仓库只是「入口」。打个比方把它想象成一家餐厅Marpit是后厨的出餐流水线——负责把 Markdown 变成幻灯片的最基础框架只管「怎么做出来」Marp Core是招牌菜和菜单——在流水线之上加上实用功能和一套内置主题决定「做出来长什么样」Marp CLI是点单柜台——你敲一条命令它就按 Core 的配方把 HTML、PDF、PPTX 端上桌Marp for VS Code是堂食服务——边写边看、点击即导出不用离开编辑器。而你现在所在的这个仓库是餐厅的总部README.md 是大门口的家族地图website/ 是官网展厅website/docs/ 是给客人看的操作手册素材则放在 website/public/assets/。各成员Marpit、Marp Core、CLI、插件的源码在各自独立的仓库里总部不代管只负责导览。5 个高频参数速查表参数写在哪作用生效范围marp: true文件顶部 front matter开启该文件的 Marp 幻灯片特性仅当前文件theme同上切换整套幻灯片的配色、字体、版式仅当前文件需先开启marppaginate: truefront matter 或任意页内的 HTML 注释显示页码当前页及其后续页可被新值覆盖headingDivider: true同上遇到标题时自动分页整个幻灯片backgroundColor某一页的 HTML 注释只给这一页设背景色当前页及其后续页补充一点local 指令会向下继承——在第 2 页设的值第 3 页没单独设的话会沿用。想「到此为止」就在后面某页显式重置。4 个常见坑的自查清单⚠️ 遇到问题先按下表对号入座现象原因一句话解法全部内容挤在同一页漏写了分页线在两张幻灯片之间补一行---写了---却渲染成分隔线---紧贴上文被当成了标题修饰线---前后各留一个空行导出 PDF / PPTX 报缺浏览器Marp 靠本地 Chromium 内核渲染先装好 Chrome 或 Edge 再重试换了theme没效果主题名拼错或 front matter 格式不对核对---包裹格式和主题拼写延伸学习 下一步想深挖指令语法、主题定制、图片语法和数学公式排版官方手册就在仓库里的 website/docs/ 目录从 安装指南 到 如何写幻灯片每篇都配了实时预览示例照着做就行。今天的作业新建一个.md文件写下marp: true再写出你人生第一行---跑一次预览——剩下的交给 Marp。【免费下载链接】marpThe entrance repository of Markdown presentation ecosystem项目地址: https://gitcode.com/gh_mirrors/mar/marp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Marp 快速上手指南3 步在本地把 Markdown 变成免费可导出的幻灯片【免费下载链接】marpThe entrance repository of Markdown presentation ecosystem项目地址: https://gitcode.com/gh_mirrors/mar/marpMarpMarkdown Presentation Ecosystem是一套免费的 Markdown 幻灯片生态你只管用纯 Markdown 写字它负责分页、套主题、排版并导出成 PDF、PPTX 或 HTML。这篇文章写给第一次接触 Marp 的人读完你不仅能 3 步在本地把官方站点跑起来还能照着完整工作流出自己第一份可放映的幻灯片。它替你省掉的 3 件事省掉排版以前在 PowerPoint 里拖文本框、对字号、等版式对齐现在一份 Markdown 文件里用---分页标题、列表、表格写出来就是成型的页面。省掉多份维护同一份 Markdown 能导出成 PDF、PPTX、HTML 三种格式渲染结果保持一致——汇报投屏用 PDF、同事接手用 PPTX、线上传播用 HTML不用为每个场合重做一遍。✍️省掉学习成本语法基于 CommonMark你已会的 Markdown 基本都能直接用Marp 只在此基础上加了分页、指令、主题这几样扩展门槛极低。3 步跑通本地 Marp 官网环境仓库是 Marp 生态的入口仓库官网和用户手册就放在里面的 website/ 目录下跑起来后可以直接浏览文档、看预览示例。拉取代码运行git clone https://gitcode.com/gh_mirrors/mar/marp然后进入marp目录。预期结果本地出现一份完整仓库含README.md、package.json和website/。安装依赖运行yarn install。仓库自带yarn.lock用它锁定版本最稳。预期结果依赖安装完成无致命报错。启动站点运行yarn website。预期结果本地开发服务器启动终端提示编译完成。跑完这步在浏览器打开 http://localhost:3000 你看到的就是完整的 Marp 官方网站Markdown 转幻灯片的实时预览示例、安装教程、指令参考、主题说明等导航一应俱全。4 种用途对应的能力版图用途触发方式产出 写作时实时看效果在 VS Code 装 Marp 扩展打开.md文件编辑器侧边即时渲染的幻灯片预览 在线放映Marp CLI 转换命令单个 HTML 文件浏览器打开即放映 投屏汇报Marp CLI 的--pdf导出可直接放映的 PDF 文件 交给同事用 PowerPoint 改Marp CLI 的--pptx导出可在 PowerPoint 中继续编辑的 PPTX 文件一次完整工作流把周会笔记变成 3 页幻灯片以「周会汇报」这个真实场景走一遍你手里只有一个写满要点的notes.md第 1 步加信封。在文件顶部写入 YAML front matter——marp: true声明这是幻灯片文件theme指定主题。这相当于告诉转换器这份文件要按幻灯片处理长这个样子。第 2 步按页切分。把笔记按「一页讲一件事」拆开每两页之间空一行后写一行---分隔线。写完的文件在 VS Code 里打开预览就能逐页检查分页是否符合预期。第 3 步按需微调。想显示页码加一行paginate: true想让大标题页自动分节加一行headingDivider: true。这些指令都写在文档的 指令参考 里随时可查。第 4 步导出交付。用 Marp CLI 把文件转成 PDF 投屏如果同事要接着改再导一份 PPTX 发过去。从写起到交稿你自始至终只写过一份 Markdown。理解生态分工一家餐厅的四层结构Marp 家族分散在多个仓库里各自维护这个仓库只是「入口」。打个比方把它想象成一家餐厅Marpit是后厨的出餐流水线——负责把 Markdown 变成幻灯片的最基础框架只管「怎么做出来」Marp Core是招牌菜和菜单——在流水线之上加上实用功能和一套内置主题决定「做出来长什么样」Marp CLI是点单柜台——你敲一条命令它就按 Core 的配方把 HTML、PDF、PPTX 端上桌Marp for VS Code是堂食服务——边写边看、点击即导出不用离开编辑器。而你现在所在的这个仓库是餐厅的总部README.md 是大门口的家族地图website/ 是官网展厅website/docs/ 是给客人看的操作手册素材则放在 website/public/assets/。各成员Marpit、Marp Core、CLI、插件的源码在各自独立的仓库里总部不代管只负责导览。5 个高频参数速查表参数写在哪作用生效范围marp: true文件顶部 front matter开启该文件的 Marp 幻灯片特性仅当前文件theme同上切换整套幻灯片的配色、字体、版式仅当前文件需先开启marppaginate: truefront matter 或任意页内的 HTML 注释显示页码当前页及其后续页可被新值覆盖headingDivider: true同上遇到标题时自动分页整个幻灯片backgroundColor某一页的 HTML 注释只给这一页设背景色当前页及其后续页补充一点local 指令会向下继承——在第 2 页设的值第 3 页没单独设的话会沿用。想「到此为止」就在后面某页显式重置。4 个常见坑的自查清单⚠️ 遇到问题先按下表对号入座现象原因一句话解法全部内容挤在同一页漏写了分页线在两张幻灯片之间补一行---写了---却渲染成分隔线---紧贴上文被当成了标题修饰线---前后各留一个空行导出 PDF / PPTX 报缺浏览器Marp 靠本地 Chromium 内核渲染先装好 Chrome 或 Edge 再重试换了theme没效果主题名拼错或 front matter 格式不对核对---包裹格式和主题拼写延伸学习 下一步想深挖指令语法、主题定制、图片语法和数学公式排版官方手册就在仓库里的 website/docs/ 目录从 安装指南 到 如何写幻灯片每篇都配了实时预览示例照着做就行。今天的作业新建一个.md文件写下marp: true再写出你人生第一行---跑一次预览——剩下的交给 Marp。【免费下载链接】marpThe entrance repository of Markdown presentation ecosystem项目地址: https://gitcode.com/gh_mirrors/mar/marp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
知识建站
内容驱动
阅读友好版式
SEO 精细化
线索转化