企业官网建设流程全解析

Marp 使用指南：用 Markdown 转 PPT，3 行命令做出专业演示文稿

【免费下载链接】marpThe entrance repository of Markdown presentation ecosystem项目地址: https://gitcode.com/gh_mirrors/mar/marp

周一要交一份技术方案，打开 PPT 软件，光标停在空白页，又是从版式、配色、字体开始折腾。换个思路：把方案当成 Markdown 来写，让工具负责排版。Marp就是这样一个把纯文本 Markdown 转成幻灯片（也就是 Markdown 演示文稿）的工具——你只管写内容，版式交给它。

🧩 Marp 是什么，解决了什么问题

一句话：Marp 把纯文本 Markdown 转成幻灯片，内容和版式互相解耦。

它的价值来自三个很实际的点：

• 纯文本，能进版本库：幻灯片就是一个.md文件，能像代码一样 diff、回滚、多人协作。
• 跨平台，零依赖：换台电脑、换个系统，文件照样能转，不需要装重型软件。
• 专注内容：不用先纠结对齐和配色，把精力放在要讲什么上。

对比传统 PPT 软件，Marp 省掉了"先想版式再填内容"的过程——你先写清楚逻辑，再决定它长什么样。

⌨️ 装好 Marp，3 行命令出第一张幻灯片

前提是装好 Node.js，然后用 npm 全局安装 Marp CLI：

npm install -g @marp-team/marp-cli marp presentation.md -o slides.pdf

第一条装工具，第二条把presentation.md转成 PDF。再配一个最小的 Markdown 文件：

--- theme: default --- # 第一张幻灯片 ---

跑完第二条命令，你的第一份演示文稿就已经生成了。上面这套就是最简单的 Marp 安装教程。

左半是 Marp CLI 在终端里的转换过程，右半是导出后打开的 PDF 预览。

📝 写幻灯片就这 3 条 Markdown 规则

Marp 的语法就建立在普通 Markdown 之上，多出来的部分拆开看只有三处：

• 分页符---：每写一次---就切出一张新幻灯片，它前面的内容归上一页。
• 标题层级#/##：#通常是封面页，##及更深层级是内容页，字号随层级变小。
• front matter 里的theme：文件最上方用两行---包起来的区域，theme: default那行就是指定主题，上面代码块里已经出现过。

看下面这个对比，就能明白#和##的差别：

# 大标题页 --- ## 内容页

小提醒：---前后最好各留一个空行，否则 CommonMark 可能把它当成分隔线而不是分页。

🎨 换皮肤：主题与样式怎么调

主题本质就是一套 CSS。Marp 内置了几套主题（如default、uncover），改theme字段就能整套切换风格；同一份文稿还能在几套主题间来回切，看哪套顺眼。

想微调时，这套 Marp 主题定制把颜色、字体、间距都暴露成了 CSS 变量——改一个变量，整份幻灯片的对应元素跟着变，不用逐页重画。团队里也可以把定制好的主题文件共享出去，大家套同一套皮肤，风格就统一了。

下面这张是用 Marp 渲染出来的一张主题幻灯片，蓝色背景、居中大字，全是主题 CSS 控制的：

📤 导出与发布：HTML / PDF / PPTX / 图片

Marp 支持四种输出，各适合不同场合：

重点说PDF：它是官方推荐的放映格式，渲染与 HTML 版本保持一致，放大不糊，断网也能放。需要讲义时，还能按页拆分导出，一页一份，发给听众当参考资料正合适。

🧰 生态与工具链：Marp 全家桶

Marp 是一整套围绕 Markdown 幻灯片的工具，三个组件各管一段：

• Marp Core：核心转换引擎，负责把 Markdown 解析成幻灯片结构。
• Marp CLI：命令行接口，前面用的就是它，适合批量转换、接 CI、做自动化。
• Marp for VS Code（即 Marp 的 VS Code 插件）：编辑器扩展，打开.md文件就能实时预览。

对多数人而言，VS Code 插件才是主力工作流——左边写、右边看，改一个词预览立刻刷新。团队协同时，把共享的主题模板和配置放进仓库，成员拉下来套同一套，输出风格就一致了。

左是带marp: true的 Markdown 源码，右是实时渲染出的幻灯片预览。

✅ 上手后的 4 条实战建议

• 全局配置写进 front matter：主题、页码、作者统一放文件头，别散落在各页里。
• 幻灯片纳入 Git：.md进版本库，每次改动都能 diff 和回滚，改坏了也不怕。
• 大项目沉淀主题模板：把配色、字体固化成一套主题文件，新文稿直接套用。
• 分页符前后留空行：---上下各空一行，防止被解析成分隔线导致渲染错位。

Marp 的核心就一句话：把幻灯片从"先排版再填内容"变回"先写内容再定样式"。下次又要交一份演示时，不妨打开终端，用 Markdown 试一下。

【免费下载链接】marpThe entrance repository of Markdown presentation ecosystem项目地址: https://gitcode.com/gh_mirrors/mar/marp