首页/新闻资讯/正文详情

Marp 快速上手指南:3 步在本地把 Markdown 变成免费可导出的幻灯片

发布时间:2026/11/4 6:06:22 来源:云帆数科 栏目:资讯中心
Marp 快速上手指南:3 步在本地把 Markdown 变成免费可导出的幻灯片
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),仅供参考

相关推荐

XAutoDaily:QQ 自动签到模块的安装配置步骤与任务失败排查
XAutoDaily:QQ 自动签到模块的安装配置步骤与任务失败排查

XAutoDaily:QQ 自动签到模块的安装配置步骤与任务失败排查 【免费下载链接】XAutoDaily 一个基于QQ的全自动签到模块 项目地址: https://gitcode.com/GitHub_Trending/xa/XAutoDaily XAutoDaily 是一款开源的 Xposed 签到模块,用于 QQ 自动签到和… · 2026/11/4 6:06:22

车载SerDes选型本质:GMSL/FPD-Link/A-PHY底层逻辑解析
车载SerDes选型本质:GMSL/FPD-Link/A-PHY底层逻辑解析

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/4 6:05:22

EtherCAT为何被称为工业‘数据高铁’?原理、同步与H5U多轴实战
EtherCAT为何被称为工业‘数据高铁’?原理、同步与H5U多轴实战

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/4 6:05:22

AI声音克隆的伦理边界:Audio8-TTS-Realistic-0.6b的局限、常见陷阱与负责任使用指南
AI声音克隆的伦理边界:Audio8-TTS-Realistic-0.6b的局限、常见陷阱与负责任使用指南

语音音频深度学习大模型本地部署 【免费下载链接】Audio8-TTS-Realistic-0.6b 项目地址: https://ai.gitcode.com/hf_mirrors/Edge0/Audio8-TTS-Realistic-0.6b 点击查看 免费下载 Audio8-TTS-Realistic-0.6b 是一个 0.6B 参数的开源 AI 声音克隆(AI vo… · 2026/11/4 6:58:29

agent-plugin安全深潜:进程内执行代码的6大审查清单项,如何守护智能体安全
agent-plugin安全深潜:进程内执行代码的6大审查清单项,如何守护智能体安全

AI 插件AI 技能插件系统人工智能开发工具 【免费下载链接】agent-plugin openJiuwen 社区官方插件仓库——一套轻量、易扩展的插件体系,让能力集成像搭积木一样简单。 项目地址: https://gitcode.com/openJiuwen/agent-plugin 点击查看 免费下载 agent-… · 2026/11/4 6:58:29

PlayCover 完全指南:Apple Silicon Mac 上跑 iOS 游戏的实践教程
PlayCover 完全指南:Apple Silicon Mac 上跑 iOS 游戏的实践教程

PlayCover 完全指南:Apple Silicon Mac 上跑 iOS 游戏的实践教程 【免费下载链接】PlayCover Community fork of PlayCover 项目地址: https://gitcode.com/gh_mirrors/pl/PlayCover 想在 M 系列 Mac 上用手柄和键鼠玩《原神》这类 iOS 独占游戏,… · 2026/11/4 6:58:29

Folia 全屏歌词播放器安装指南:4 条路径从零跑通第一首
Folia 全屏歌词播放器安装指南:4 条路径从零跑通第一首

Folia 全屏歌词播放器安装指南:4 条路径从零跑通第一首 【免费下载链接】folia-major 专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器 项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major Folia 是把歌词渲染成全屏动… · 2026/11/4 6:58:29

PDFPatcher:书签编辑、文档合并到无损提取图片的免费 PDF 工具箱完整实战指南
PDFPatcher:书签编辑、文档合并到无损提取图片的免费 PDF 工具箱完整实战指南

PDFPatcher:书签编辑、文档合并到无损提取图片的免费 PDF 工具箱完整实战指南 【免费下载链接】PDFPatcher PDF补丁丁——PDF工具箱,可以编辑书签、剪裁旋转页面、解除限制、提取或合并文档,探查文档结构,提取图片、转成图片等等 … · 2026/11/4 6:58:29

首次开源材料晶体结构生成:40% 通过率吊打 GPT-5.5 的技术拆解
首次开源材料晶体结构生成:40% 通过率吊打 GPT-5.5 的技术拆解

首次开源材料晶体结构生成:40% 通过率吊打 GPT-5.5 的技术拆解 【免费下载链接】Intern-S2-397B 项目地址: https://ai.gitcode.com/InternLM/Intern-S2-397B 材料科学的智能计算,长期卡在"最后一公里":模型能读懂论文、能… · 2026/11/4 6:57:29

双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/4 3:16:49

STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/3 6:04:24

DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/3 5:52:46

AI辅助技术栈评估:提升研发决策效率60%
AI辅助技术栈评估:提升研发决策效率60%

1. 项目背景与核心价值技术决策一直是研发团队面临的重大挑战。随着技术生态的快速演进,技术栈的选择、维护和迭代变得愈发复杂。我们团队在过去两年里,先后经历了三次重大技术栈迁移,每次都需要投入大量人力进行技术评估和风险分析。直到去年… · 2026/11/4 0:00:17

从生成Token到直接决策:Jev如何重塑AI Agent工程实践
从生成Token到直接决策:Jev如何重塑AI Agent工程实践

1. 从"生成文字"到"拍板决策":Jev 到底在解决什么问题大多数人第一次接触大模型,脑子里建立的模型是"输入问题、输出文字"。你问它今天天气怎么样,它给你一段描述;你让它写个周报,它给你… · 2026/11/4 0:00:17

32G统一内存跑大模型:内存账、TPS实测与端云分流
32G统一内存跑大模型:内存账、TPS实测与端云分流

想在一台 32G 统一内存的小主机上把大模型跑成"日常可用",这件事我前后折腾了小半年。标题里说的这台 Mac mini M6,是我们这次讨论的目标平台,具体到手规格以实物为准;但下面这套推算方法和实测思路,对任何统… · 2026/11/4 0:00:17

双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/4 3:16:49

STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/3 6:04:24

DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/3 5:52:46

了解更多?预约专属演示

我们的顾问将为您一对一讲解产品与方案

企业微信二维码