Files
llm_wiki/wiki/Obsidian Marp 插件.md

2.5 KiB
Raw Permalink Blame History

categories, tags, created, source, type, aliases
categories tags created source type aliases
Marp
marp
obsidian
plugin
2026-04-07 marp-guide reference
Obsidian Marp
Marp Obsidian

Obsidian Marp 插件

在 Obsidian 中实时预览和导出 Marp 幻灯片。

基本信息

核心功能

1. 实时预览

  • 点击侧边栏的 Marp 图标,或
  • 命令面板运行 Marp: Open Preview
  • 支持分栏预览(一边编辑一边看效果)
  • 保存文件后自动刷新

2. 导出

  • 支持格式PDF、PPTX、HTML
  • 输出目录:固定为 Downloads
  • 图片自动转 Base64 嵌入
  • HTML 格式支持页面过渡动画

3. 图片支持

两种格式都支持:

<!-- Wikilink 格式 -->
![[path/to/image.png]]

<!-- CommonMark 格式 -->
![alt](path/to/image.png)

路径支持绝对路径和相对路径(相对于 vault 根目录)。

设置项

设置 类型 默认值 说明
Enable Auto Reload toggle on 保存时自动刷新预览
Open Preview in Split Tab toggle on 分栏打开预览
Theme Folder Location text MarpTheme 自定义主题 CSS 目录路径(建议设为 Templates/MarpTheme

自定义主题

在 vault 中创建主题目录(插件设置中 Theme Folder Location 默认为 MarpTheme

<vault>/
└── Templates/
    └── MarpTheme/
        ├── beamer.css
        └── gradient.css

[!tip] 插件设置中的 Theme Folder Location 应配置为 Templates/MarpTheme

然后在幻灯片中使用:

---
marp: "true"
theme: beamer
---

[!warning] 添加新 CSS 文件后需要重启 Obsidian 才能识别。

工作流程

graph LR
    A["📝 编辑 .md"] --> B["👁️ Marp 预览"]
    B --> C["满意?"]
    C -->|是| D["📤 导出"]
    C -->|否| A
    D --> E["📄 PDF/PPTX/HTML"]

使用前检查清单

  • 安装 Obsidian Marp 插件(社区插件市场搜索 "Marp"
  • 安装 Node.js导出功能需要
  • 在 Markdown 文件 front-matter 中加 marp: "true"
  • --- 分页

相关页面