★ FEATURED ARTICLE Marp3步跑通 Markdown 转演示从一份 .md 文件到能直接交付的 PDF【免费下载链接】marpThe entrance repository of Markdown presentation ecosystem项目地址: https://gitcode.com/gh_mirrors/mar/marpMarp 是一个把 Markdown 转成演示文件的工具在 .md 里写幻灯片一行命令导出 PDF 或 PPTX。上次复盘会40 分钟的内容被排版耗掉一个半小时换成 Marp版面花费的时间就压缩成跑一次导出命令。整套流程从安装到拿到第一份 PDF网络好的话不超过 5 分钟。Marp 的能力边界它做什么不做什么定位一句话Marp 负责「文字变幻灯片」这一步至于怎么写得好看交给 Markdown 本身。它做的是把一份 .md 文件变成 PDF、PPTX、HTML、图片这些演示载体核心转换由 Marp Core 完成命令行导出由 Marp CLI 负责。它不做的是提供可视化编辑画布、不做拖拽排版、不做动画时间线——幻灯片结构由你写的 Markdown 决定写什么样就是什么样。这个边界反而让 Markdown 转演示很适合放进版本控制幻灯片是纯文本可以进 git、可以按行 diff 评审、不会有二进制文件冲突。交付一版改动推个分支就行不用邮件传附件。如果你要的是拖元素、做 3D 转场Marp 不是合适工具如果痛点是「内容写得快、变正式慢」这条路线值得跑一次。5分钟从安装到第一份 PDFMarp Markdown 转演示主流程跑通 Marp Markdown 转演示的主流程就三步装 CLI、写最短的 .md、跑导出命令。PDF 出来之后剩下的全是加内容的事。第一步安装 Marp CLI它会带上 PDF 渲染所需的无头浏览器运行时npm install -g marp-team/marp-cli在项目目录建一个 deck.md四行就够——front matter 指定主题一个 H1 就是第一张幻灯片--- theme: default --- # Hello, Marp保存后在同一目录执行导出--pdf指定输出 PDF文件名默认与输入相同marp deck.md --pdf目录里会多出 deck.pdf。想边写边看效果直接跑marp deck.md会打开浏览器预览并监听文件变更参数全表可以查Marp CLI 说明页。图里左侧是两条转换命令及日志输出右侧是生成 PDF 的第一页——这就是 Markdown 转演示工作流的最小闭环。让输出符合自己的风格主题和页面尺寸两行配置 让 Marp 的输出符合自己的风格其实就靠 front matter 里两个键不用碰 CSS。theme决定整套幻灯片的视觉内置的default、gaia、uncover换个值就是另一套配色size控制页面比例默认16:9老投影或打印场景改成4:3--- theme: uncover size: 4:3 ---内置主题之外可以放一个自己的 CSS 文件注册成自定义主题导出时用--theme指认团队把主题文件放进共享仓库大家导出的产出就保持一致。主题怎么写可以翻主题指南日常使用上面两行配置已经覆盖大多数需求。不同交付场景选哪种输出正式演示、讲义分发、文档嵌入各归各位选输出格式应该从场景出发而不是从扩展名出发。同一份 deck.mdMarp 的 Markdown 转演示支持 PDF、PPTX、HTML、图片四类输出选择逻辑并不复杂。正式演示或对外发送用 PDF。矢量文字、页数固定对方在任何环境打开都不会串版字体也不会被替换。讲义分发还是 PDFfront matter 里设paginate: true加上页码!-- --里的演讲者备注会随 PPTX 导出讲的人用得上。接收方要在 Office 里继续改选 PPTX。Marp 会把每张幻灯片变成可编辑的页面适合做交接底稿但样式复杂时 PPTX 的转换是近似的对外展示的版本请回退到 PDF。嵌入内部文档或群聊用单页图片或自包含 HTML。PNG 直接插图HTML 把所有 CSS 内联进单个文件浏览器打开即看适合挂在内部知识库做预览。嵌入日常开发流在 VS Code 里写在 CI 里生成 ⚙️Markdown 转演示和用 PPT 软件的真正差别在开发流里体现写、预览、导出都能发生在你已经在用的工具中。最直接的集成是 VS Code 扩展 Marp for VS Code。装好后在 .md 的 front matter 加一行marp: true编辑器旁边就会出幻灯片预览--- marp: true ---预览面板随输入实时更新换主题立刻生效——相当于给 Markdown 文件开了 PPT 预览模式其余写作习惯完全不用改。另一半是自动化把marp deck.md --pdf放进 CI 步骤每次 push 自动重建 deck产物挂到 PR 或 commit 上。对文档和演示同步维护的团队来说这相当于在编译步骤里多了一个 deck build再也不用有人记住「导出后发到群里」这件事。三个高频踩坑与解法现象、根因、处理Marp Markdown 转演示的流程虽然简单第一次跑还是会撞几个坑。三个高频的现象VS Code 里打开 .md明明看着正常就是不出现幻灯片预览。 根因front matter 没写marp: true声明扩展识别不了这是 Marp 幻灯片。 处理文件开头补上声明预览立刻出现。现象导出 PDF 后中文全变方块。 根因渲染用的无头浏览器在机器或容器环境里缺中文字体。 处理装一个 CJK 字体包如 Noto Sans CJK或用--browser指定本机已装 Chrome 的路径。现象代码块或长表格撑出页面下沿下一行被截断。 根因幻灯片高度固定Marp 默认不会自动缩小超长内容。 处理在该块前加!-- fit --指令触发自动缩放或者把内容拆成两张幻灯片——后者通常更干净。Marp 的价值在于把「写完到能交付的演示文件」压缩成一条命令同时让幻灯片成为可版本化、可评审的文本资产。如果你最近要开一场技术分享现在就在项目根目录建一个slides/目录写一份用 default 主题的 deck.md跑一次marp deck.md --pdf——下一次分享流程就已经是现成的了。【免费下载链接】marpThe entrance repository of Markdown presentation ecosystem项目地址: https://gitcode.com/gh_mirrors/mar/marp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
阅读完成 · 觉得有帮助？
