llm_wiki/wiki/Marp.md

categories, tags, created, source, type, aliases

categories	tags	created	source	type	aliases
Marp	marp presentation markdown 工具	2026-04-07	marp-guide	concept	Marp Marp 生态系统

Marp

一句话：用纯 Markdown 写演示文稿的开源生态系统。

是什么

Marp 让你用 Markdown 编写幻灯片，然后导出为 HTML、PDF、PPTX 或图片。不需要 PowerPoint，不需要 Keynote，只需要一个 .md 文件。

graph LR
    A["📝 Markdown<br/>源文件"] --> B["⚙️ Marp Core<br/>渲染引擎"]
    B --> C["📄 HTML"]
    B --> D["📋 PDF"]
    B --> E["📊 PPTX"]
    B --> F["🖼️ 图片"]

核心组件

组件	说明	仓库
Marpit	瘦框架，Markdown → 幻灯片	marp-team/marpit
Marp Core	核心引擎，含内置主题	marp-team/marp-core
Marp CLI	命令行导出工具	marp-team/marp-cli
Marp for VS Code	VS Code 实时预览	marp-team/marp-vscode
Obsidian Marp Plugin	Obsidian 集成	JichouP/obsidian-marp-plugin

核心设计理念

1. 纯文本优先 — 幻灯片就是 Markdown 文件，用 Git 管理、用任何编辑器打开
2. 关注点分离 — 内容（Markdown）与样式（CSS 主题）分离
3. 指令系统 — 通过 HTML 注释或 front-matter 控制幻灯片行为
4. 模块化 — Marpit（框架）→ Marp Core（引擎）→ CLI/插件（应用层）

最小示例

---
marp: "true"
theme: uncover
paginate: "true"
---

# 标题页

---

## 第二页

- 就这么简单
- 真的

--- 分页，marp: true 启用，theme: 选主题。完了。

关键概念

• Marp 指令语法 — 控制幻灯片行为的指令系统
• Marp 主题与样式 — 内置主题和自定义 CSS
• Marp 主题推荐 — GitHub 社区优质主题合集与场景推荐
• Marp 导出 — HTML/PDF/PPTX 导出选项
• Obsidian Marp 插件 — 在 Obsidian 中使用 Marp
• 示例-学校定制Marp演示 — 学校定制主题的完整演示示例

相关工具

• Obsidian — 可作为 Marp 的编辑/预览环境
• LLM Wiki — Marp 可用于从 wiki 内容生成幻灯片

来源

• marp-guide — 原始资料汇编