a6f05ab2d5
- Phase 0: AGENTS.md cleanup (dedup quotes, renumber sections, merge qmd) - Phase 1: typed relations (manage-relations.py, graph-search.py, check-staleness.py, detect-conflicts.py) - Phase 2: frontmatter validator, weekly lint, knowledge promotion, git hooks - Fix .gitignore to track tools/ and .githooks/ - Fix git remote URL (remove plaintext token) - New wiki pages: 504 pages, 34 raw sources
2.0 KiB
2.0 KiB
categories, tags, created, source, type, aliases
| categories | tags | created | source | type | aliases | |||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
2026-04-07 | marp-guide | reference |
|
Marp 导出
Marp 支持将 Markdown 幻灯片导出为 HTML、PDF、PPTX 和图片。
导出方式对比
| 方式 | 平台 | 需要安装 | 适合场景 |
|---|---|---|---|
| Obsidian Marp 插件 | Obsidian | Node.js | 快速导出到 Downloads |
| Marp CLI | 终端 | Node.js / brew / scoop | 自动化、批处理 |
| VS Code 扩展 | VS Code | 扩展商店 | 编辑+导出一体 |
Marp CLI 安装
# npm(推荐,无需全局安装)
npx @marp-team/marp-cli@latest
# macOS
brew install marp-cli
# Windows (Scoop)
scoop install marp
常用命令
# 导出 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 插件导出
- 打开 Marp 预览(侧边栏按钮或命令面板
Marp: Open Preview) - 在预览窗口点击导出按钮
- 选择格式(PDF / PPTX / HTML)
- 文件自动保存到
Downloads目录
[!note] 导出的文件中图片自动转为 Base64 嵌入,方便分享。
来源
相关页面
详见 Marp 导出
- marp-guide — 原始资料
- Marp — Marp 概念页