Marp 入门与教程

一、什么是 Marp？

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

与 LaTeX 的 Beamer 比较：

总结：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


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

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


1. 导出为 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;
}


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

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


1. 应用主题
   使用 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，并将其高效应用于日常工作和学习中。