Marp Markdown 演示文稿创建工具教程

1. 项目介绍

Marp 是一个Markdown演示文稿创作生态系统，它允许用户利用纯Markdown语法来制作美观且功能丰富的幻灯片。该项目由多个子组件组成，包括轻量级框架Marpit，核心转换器Marp Core以及用于Visual Studio Code的扩展插件等。此外，Marp团队还提供了CLI界面和Web应用支持，以满足不同用户的创作需求。

2. 项目快速启动

安装Marp CLI（命令行工具）

首先，确保已经安装了Node.js环境，然后通过npm全局安装Marp CLI：

npm install --global marp-cli

创建并预览演示文稿

在你的工作目录中创建一个新的Markdown文件，例如presentation.md，然后输入基本的Markdown和幻灯片语法：

---
title: 我的第一个Marp演示文稿
---

# 第一张幻灯片

这是一个简单的文本段落。

---

# 第二张幻灯片

* 列表项1
* 列表项2

现在，在终端中运行以下命令实时预览你的演示文稿：

marp presentation.md

浏览器将自动打开显示预览页面。保存presentation.md时，预览也会自动更新。

转换为HTML或PDF

要将演示文稿导出为HTML或PDF，使用以下命令：

# 导出为HTML
marp presentation.md --export presentation.html

# 导出为PDF
marp presentation.md --export presentation.pdf

3. 应用案例和最佳实践

• 学术报告：使用Marp编写简洁明了的学术报告，保持Markdown格式易于管理和分享。
• 在线讲座：结合PWA特性，Marp Web可以提供离线访问的讲座材料。
• 团队会议：快速创建和共享会议议程，利用Markdown注释功能进行讨论。

最佳实践：

• 使用Marp提供的主题定制幻灯片样式。
• 分割Markdown文件以组织长篇内容。
• 利用Markdown表格、嵌入代码块和数学公式增强内容表达。

4. 典型生态项目

• Marpit: 简单的框架，用于构建Markdown幻灯片。
• Marp Core: 提供核心转换功能和内置主题。
• Marp for VS Code: 与VS Code集成的扩展，提供实时预览和导出功能。
• Marp CLI: 命令行工具，方便转换Markdown到多种格式。

探索更多生态项目，如Marp React和Marp Vue，它们是React和Vue的渲染组件，适合在Web应用中嵌入Marp幻灯片。