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

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 插件。

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

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

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

1

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

2

2. 使用 CLI 工具

功能简介

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

入门教程

安装 CLI 工具

安装 Node.js 环境。

执行以下命令安装 Marp CLI：

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

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

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

导出为 PDF 或 HTML

导出 PDF：

marp slide.md -o slide.pdf

实时预览：

marp slide.md --preview

3. 自定义主题

功能简介

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

入门教程

创建主题 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;
}

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

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

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