99 lines
2.0 KiB
Markdown
99 lines
2.0 KiB
Markdown
---
|
||
categories:
|
||
- "[[Marp]]"
|
||
tags:
|
||
- marp
|
||
- export
|
||
- cli
|
||
created: 2026-04-07
|
||
source: "[[marp-guide]]"
|
||
type: reference
|
||
aliases:
|
||
- Marp 导出
|
||
- Marp CLI
|
||
---
|
||
|
||
# Marp 导出
|
||
|
||
> Marp 支持将 Markdown 幻灯片导出为 HTML、PDF、PPTX 和图片。
|
||
|
||
## 导出方式对比
|
||
|
||
| 方式 | 平台 | 需要安装 | 适合场景 |
|
||
|------|------|----------|----------|
|
||
| **Obsidian Marp 插件** | Obsidian | Node.js | 快速导出到 Downloads |
|
||
| **Marp CLI** | 终端 | Node.js / brew / scoop | 自动化、批处理 |
|
||
| **VS Code 扩展** | VS Code | 扩展商店 | 编辑+导出一体 |
|
||
|
||
## Marp CLI 安装
|
||
|
||
```bash
|
||
# npm（推荐，无需全局安装）
|
||
npx @marp-team/marp-cli@latest
|
||
|
||
# macOS
|
||
brew install marp-cli
|
||
|
||
# Windows (Scoop)
|
||
scoop install marp
|
||
```
|
||
|
||
## 常用命令
|
||
|
||
```bash
|
||
# 导出 HTML（默认）
|
||
marp presentation.md
|
||
|
||
# 导出 PDF
|
||
marp presentation.md --pdf
|
||
|
||
# 导出 PPTX
|
||
marp presentation.md --pptx
|
||
|
||
# 导出图片（每页一张 PNG）
|
||
marp presentation.md --images
|
||
|
||
# 指定输出文件
|
||
marp presentation.md -o slides.html
|
||
|
||
# 使用特定主题
|
||
marp --theme uncover --pdf presentation.md
|
||
|
||
# 导出后立即打开
|
||
marp presentation.md --pdf --open
|
||
|
||
# 允许加载本地图片
|
||
marp presentation.md --pdf --allow-local-files
|
||
```
|
||
|
||
> [!warning] PDF 和 PPTX 导出需要系统安装 **Chrome 或 Edge**（使用 Chromium 渲染引擎）。
|
||
|
||
## HTML 导出特点
|
||
|
||
- 完整样式和主题支持
|
||
- 交互式导航（方向键、空格键）
|
||
- 自定义过渡效果和动画
|
||
- 响应式设计，适应不同屏幕
|
||
- 适合通过链接分享
|
||
|
||
## PDF 导出特点
|
||
|
||
- 跨设备通用
|
||
- 适合打印
|
||
- 排版一致
|
||
- 离线可用
|
||
|
||
## Obsidian Marp 插件导出
|
||
|
||
1. 打开 Marp 预览（侧边栏按钮或命令面板 `Marp: Open Preview`）
|
||
2. 在预览窗口点击导出按钮
|
||
3. 选择格式（PDF / PPTX / HTML）
|
||
4. 文件自动保存到 `Downloads` 目录
|
||
|
||
> [!note] 导出的文件中图片自动转为 Base64 嵌入，方便分享。
|
||
|
||
## 来源
|
||
|
||
- [[marp-guide]] — 原始资料
|
||
- [[Marp]] — Marp 概念页
|