Marp 入门与教程：让你一分钟爱上代码写PPT的乐趣

Marp 入门与教程

一、什么是 Marp？

Marp 是一个基于 Markdown 的开源幻灯片制作工具，可以轻松将 Markdown 文档转换为精美的幻灯片。其核心是 Marpit 框架，支持可定制主题、多种输出格式和动态功能。

与 LaTeX 的 Beamer 比较：

对比项	Marp	LaTeX (Beamer)
易用性	使用 Markdown 语法，易学易用	基于 TeX，语法复杂，学习曲线陡峭
功能扩展性	- 支持 CSS 定制 - 支持图片背景 - 支持 Mermaid 图表 - 支持自动布局和响应式设计	- 强大的数学公式支持 - 适合编写专业文档 - 高级的排版控制
输出支持	HTML、PDF、PPTX	PDF
实时预览	可通过 VS Code 插件快速预览	缺乏直观的实时预览
适用场景	快速演示文稿、轻量级幻灯片	高端学术演示或复杂幻灯片

总结：Marp 更适合需要快速生成现代化演示文稿的用户，而 LaTeX Beamer 更适合专业的学术排版。

---

二、Marp 支持的功能

1. 通过插件快速制作：支持 VS Code 插件和实时预览。
2. 命令行工具 (CLI)：批量处理，导出 HTML、PDF 等格式。
3. 支持 YAML 配置：灵活设置幻灯片主题、尺寸和分页。
4. 自定义样式：支持 CSS 修改主题和排版样式。
5. 嵌入动态内容：如代码高亮、公式 (MathJax)、图片背景等。
6. 多种主题支持：内置主题（default、gaia、uncover）和自定义扩展主题。

---

三、功能介绍与入门教程

1. 使用 VS Code 插件

功能简介

• 提供实时预览功能。
• 可一键导出 PDF。
• 支持 Markdown 语法高亮。

入门教程

1. 安装 VS Code 和插件

   • 下载并安装 VS Code。
   • 在扩展商店搜索并安装 Marp for VS Code 插件。

2. 新建 Markdown 文件
   创建一个 .md 文件，并在文件开头加入以下 YAML 配置：

   ---
   marp: true
   theme: uncover
   size: 16:9
   paginate: true
   backgroundColor: #f0f0f0
   ---
   
   

3. 实时预览
   点击下图 Marp 图标，即可看到实时幻灯片预览。

   

4. 导出 PPT
   点击下图图标，选择Export……，最后在保存类型处点击下拉框选择要保存的文件类型
   

---

2. 使用 CLI 工具

功能简介

• 支持批量生成和自动化处理。
• 输出 HTML、PDF 等格式。

入门教程

1. 安装 CLI 工具

   • 安装 Node.js 环境。

   • 执行以下命令安装 Marp CLI：

     npm install -g @marp-team/marp-cli
     

2. 创建 Markdown 幻灯片
   示例内容如下：

   ---
   marp: true
   theme: gaia
   size: 4:3
   ---
   # 欢迎使用 Marp
   - 简单
   - 快速
   - 美观
   

3. 导出为 PDF 或 HTML

   • 导出 PDF：

     marp slide.md -o slide.pdf
     

   • 实时预览：

     marp slide.md --preview
     

---

3. 自定义主题

功能简介

通过 CSS 修改样式，满足品牌化或个性化需求。

入门教程

1. 创建主题 CSS 文件

   @import 'https://fonts.googleapis.com/css?family=Roboto';
   
   section {
       font-family: 'Roboto', sans-serif;
       background-color: #ffffff;
       color: #333333;
   }
   
   h1 {
       font-size: 2.5em;
       color: #ff5733;
   }
   

2. 引用自定义主题
   在 Markdown 文件中添加：

   ---
   marp: true
   theme: custom
   ---
   

3. 应用主题
   使用 CLI 或插件预览效果。

---

四、Marp 的优势与应用案例

1. 快速上手：

   • 对比 LaTeX Beamer，不需要复杂的语法和环境配置，学习成本低。
   • YAML 配置简单明了。

2. 跨平台支持：

   • 支持在不同系统（Windows、macOS、Linux）下运行，且兼容多种编辑器。

3. 现代化设计：

   • 内置主题时尚美观，支持动态背景和交互内容。

4. 适用场景丰富：

   • 技术分享：嵌入代码片段、公式等内容。
   • 工作汇报：快速制作专业化演示文稿。
   • 教学场景：Markdown 文本轻松生成幻灯片。

应用案例：

• 技术分享：通过 VS Code 插件，工程师可以快速构建内含代码高亮的技术演示。
• 团队培训：CLI 批量生成幻灯片，满足大规模培训需求。
• 个人总结：写笔记的同时生成高质量幻灯片，一举两得。

---

五、学习参考链接

1. Marp 官方网站
2. Marp VS Code 插件
3. Marpit Markdown 文档
4. 少数派 Marp 教程
5. Marp GitHub 仓库

---

按以上步骤学习后，相信你能快速掌握 Marp，并将其高效应用于日常工作和学习中。