SuperAPI AI Directory

marp-slides-creator

Office & productivity

View repository

Updated 10-15 17:30

About this skill

Marp Slides Creation Assistant

Skill Overview

This skill provides a systematic multi-stage Marp presentation creation workflow, from workspace initialization to final draft output. For Chinese presentations, it additionally includes a Chinese language standards review stage. All analysis reports, first drafts, review documents, PNG exports, and final drafts are stored together in the project work folder for easy management and traceability.

Supports multiple theme styles: Built-in 14 selected themes, covering academic, business, creative, and other scenarios. See themes/README.md。

Core Principles

Slides Design Principles

Principle Description Key Points
One point per page Each page covers only one core idea Avoid information overload
Visual hierarchy Title → Key points → Details Use bold, lists, and quotes to differentiate
Ample white space Content should not exceed 60% of the page Give the audience room to breathe
Concise text No more than 8 lines of text per page Keywords are better than complete sentences

Content Density Control

  • Title page: Main title + subtitle + author information
  • Content page: Title + 3-5 key points (1-2 lines each)
  • Comparison page: Two-column comparison, no more than 4 points per column
  • Summary page: 3-5 core key points

Seven-Stage Workflow

Strictly follow the process below, and ask the user for confirmation after each stage:

Stage Zero: Workspace Initialization and Theme Selection (Preprocessing)

Trigger: Execute immediately when the user requests slide creation

Execution Steps:

  1. Determine the project name:

    • Determine the project name based on the topic/file name provided by the user
    • Use a short English or pinyin name, connected with hyphens
    • Example:academic-writing、ai-introduction、product-launch
  2. Create the work folder structure:

    # 创建主工作文件夹和子目录
    mkdir -p slides_[项目名]/{01_analysis,02_drafts,03_reviews,04_exports,05_final}
    
  3. Folder structure description:

    slides_[项目名]/
    ├── 01_analysis/           # 阶段一:分析报告
    │   ├── content-analysis.md   # 内容分析报告
    │   └── outline.md            # Slides大纲
    ├── 02_drafts/             # 阶段二:初稿
    │   └── presentation.md       # Slides初稿
    ├── 03_reviews/            # 阶段三:审阅报告
    │   ├── content-review.md     # 内容审阅
    │   ├── format-review.md      # 格式审阅
    │   ├── density-review.md     # 密度审阅
    │   ├── visual-review.md      # 视觉审阅
    │   ├── chinese-review.md     # 中文规范审阅(仅中文)
    │   └── summary.md            # 综合审阅报告
    ├── 04_exports/            # 阶段四:PNG/HTML导出
    │   ├── slide_001.png
    │   ├── slide_002.png
    │   └── slides.html
    ├── 05_final/              # 阶段五:终稿
    │   ├── presentation.md       # 最终Markdown
    │   ├── slides.html           # HTML版本
    │   └── slides.pdf            # PDF版本(可选)
    └── README.md              # 项目说明文件
    
  4. Theme selection:

    Use the AskUserQuestion tool to let the user choose a theme style:

    questions:
      - question: "请选择演示文稿的主题风格"
        header: "主题风格"
        multiSelect: false
        options:
          - label: "academic (学术风格)"
            description: "适合学术报告、论文答辩,maroon红色标题栏"
          - label: "beam (Beamer风格)"
            description: "仿LaTeX Beamer,适合学术演讲、技术研讨"
          - label: "jobs (乔布斯风格)"
            description: "Apple发布会风格,适合产品发布、商业演示"
          - label: "graph_paper (方格纸风格)"
            description: "技术分享、教学演示,手写笔记感"
    

    Available theme list(categorized by scenario):

    Scenario Theme options
    Academic defense academic, beam, zju
    Technical sharing graph_paper, beam, turing
    Product launch jobs, gradient
    Corporate reporting companyLightBlue, companySZ
    Teaching demonstration simple, graph_paper, academic
    Creative showcase gradient, jobs, socrates

    Theme file location:themes/ All .css files under the directory

  5. Create README.md:

    # [项目名] Slides
    
    ## 项目信息
    - 创建时间:[日期]
    - 输入材料:[原始文件名]
    - 主题:[主题描述]
    - **使用主题**:[选择的主题名称,如 academic/beam/jobs 等]
    
    ## 文件夹说明
    - `01_analysis/` - 内容分析和大纲
    - `02_drafts/` - Slides初稿
    - `03_reviews/` - 审阅报告
    - `04_exports/` - PNG和HTML导出
    - `05_final/` - 最终版本
    
    ## 制作进度
    - [ ] 阶段零:工作空间初始化
    - [ ] 阶段一:内容分析
    - [ ] 阶段二:初稿制作
    - [ ] 阶段三:多维度审阅
    - [ ] 阶段三B:中文语言规范审阅(仅中文演示文稿)
    - [ ] 阶段四:PNG转换检查
    - [ ] 阶段五:问题修复与终稿
    

Output: The work folder path and the selected theme name, informing the user that all outputs will be saved in this folder


Stage 1: Content Analysis and Digestion

Trigger: After the workspace is created, the user provides input files (PDFs, papers, documents, notes, etc.)

Execution Steps:

  1. Initial Reading: Use the Read tool to read the input file and understand the overall structure
  2. In-depth Analysis:
    • Extract core arguments and key information
    • Identify the logical structure (problem-solution-conclusion / current state-analysis-recommendation, etc.)
    • Mark important data, citations, and cases
  3. Content Classification:
    • Core viewpoints (must include)
    • Supporting evidence (selectively include)
    • Background information (simplify or omit)
  4. Outline Generation:
    • Determine the number of slides (10-20 pages recommended)
    • Plan the topic and content density of each page
    • Design the narrative flow

File Saving:

  • Content analysis report:slides_[项目名]/01_analysis/content-analysis.md
  • Slides outline:slides_[项目名]/01_analysis/outline.md

Output Template:

01_analysis/content-analysis.md:

## 内容分析报告

### 文档概述
- 主题:[主题]
- 类型:[论文/报告/教程/...]
- 核心论点:[1-2句话]

### 关键内容提取
1. [关键点1]
2. [关键点2]
...

01_analysis/outline.md:

## Slides大纲(预计X页)

1. 标题页
2. [内容页标题]
3. ...

Stage 2: Slides First Draft Creation

Trigger: The user confirms the content analysis and outline

Execution Steps:

  1. Read Template: Use the Read tool to read marp-template.md

  2. Apply Theme:

    • Set the theme selected by the user in the YAML frontmatter:
      ---
      marp: true
      theme: [用户选择的主题名]
      ---
      
    • Different themes may support special classes; refer to themes/README.md
  3. Theme Adaptation (automatic adjustment):

    Different themes have different requirements for title formatting, and when creating slides you must automatically adjust according to the theme:

    Theme Content Page Title Format Description
    beam # (h1) h1 is displayed in the blue bar at the top
    academic # (h1) h1 is used for the page title
    jobs # (h1) h1 has a special underline style
    graph_paper ## (h2) Standard h2 title
    simple ## (h2) Standard h2 title
    Other Themes ## (h2) Use h2 by default

    Special handling for the beam theme:

    • The first # (h1) on each page is automatically displayed in the blue decorative bar at the top
    • The title page uses the <!-- _class: title --> directive
    • Content pages directly use the # title (not ##)
    • Example:
      ---
      # 页面标题在蓝色条中
      
      正文内容...
      

    Special handling for the academic/jobs themes:

    • Also use # (h1) as the page title
    • Supports class: lead for special pages
  4. Must include centering styles: The frontmatter's style must include the following CSS, otherwise images and tables will be left-aligned:

    /* 图片居中 */
    img {
      display: block !important;
      margin: 0 auto !important;
    }
    /* 表格居中(覆盖主题的 width:100% 和 display:block) */
    section table {
      display: table !important;
      width: auto !important;
      margin-left: auto !important;
      margin-right: auto !important;
    }
    

    Reason: Marp's base CSS sets section table { display: block; width: max-content }, and most custom themes also set table { width: 100% }, both of which cause tables to fail to center. You must use !important to override all three properties display、width and margin at the same time for it to take effect.marp-template.md already includes these styles.

  5. Modify Header/Footer: Adjust according to the presentation topic

  6. Create page by page:

    • Follow the page types and formats in the template
    • Strictly control the amount of content per page
    • Use appropriate Markdown formatting (bold, quotes, lists)

Page Type Selection(Reference references/slide-types.md):

  • Title Page: Opening
  • Table of Contents Page: Content preview
  • Single-Point Page: Display of a core point
  • List Page: Display of multiple key points
  • Comparison Page: Comparison of two viewpoints/options
  • Quote Page: Display of important quotes
  • Divider Page: Chapter transition
  • Summary Page: Review of key points

File Saving:

  • Save draft:slides_[项目名]/02_drafts/presentation.md
  • Update the progress status in README.md

Phase Three: Multi-Dimensional Parallel Review

Trigger: Automatically enter after the first draft is completed

Execution Method: Use the Task tool to dispatch 4 specialized agents in parallel, each responsible for one review dimension

Parallel Agent Deployment:

在单个消息中同时发起4个Task调用,设置 run_in_background=true:

Agent 1: Content Review Expert

Task 工具参数:
- subagent_type: "general-purpose"
- run_in_background: true
- prompt:

你是一个内容审阅专家。请对比审阅slides内容。

## 输入材料

### 用户原始输入文件
[插入用户提供的原始文件内容]

### 用户的具体要求
[插入用户提出的要求和偏好]

### 制作的Slides初稿
[插入presentation.md内容]

## 审阅任务

1. **完整性检查**:
   - 原始材料中的核心论点是否都已体现?
   - 是否有重要信息被遗漏?
   - 列出遗漏的关键内容

2. **准确性检查**:
   - slides内容是否准确反映原始材料?
   - 是否有曲解或过度简化?
   - 数据和事实是否正确转述?

3. **用户要求符合度**:
   - 是否满足用户提出的具体要求?
   - 风格和重点是否符合用户期望?
   - 列出未满足的要求

4. **逻辑流检查**:
   - 叙事顺序是否合理?
   - 各页之间过渡是否自然?
   - 整体结构是否清晰?

## 输出格式

### 内容审阅报告

#### 完整性评估
- 评分:[A/B/C/D]
- 遗漏内容:[列表]

#### 准确性评估
- 评分:[A/B/C/D]
- 问题页面:[页码和问题描述]

#### 用户要求符合度
- 评分:[A/B/C/D]
- 未满足要求:[列表]

#### 逻辑流评估
- 评分:[A/B/C/D]
- 建议调整:[具体建议]

#### 需修改页面清单
| 页码 | 问题类型 | 问题描述 | 修改建议 |
|------|----------|----------|----------|
| ... | ... | ... | ... |

Agent 2: Format Review Expert

Task 工具参数:
- subagent_type: "general-purpose"
- run_in_background: true
- prompt:

你是一个Marp格式审阅专家。请检查slides的格式规范性。

## Slides内容
[插入presentation.md内容]

## 审阅任务

1. **YAML Frontmatter检查**:
   - marp: true 是否存在?
   - theme 是否正确设置?
   - header/footer 是否配置?
   - style 块语法是否正确?

2. **分页符检查**:
   - `---` 分页符是否正确使用?
   - 是否有多余或缺失的分页符?
   - 分页符前后是否有空行?

3. **Markdown语法检查**:
   - 标题层级是否正确(#, ##, ###)?
   - 列表格式是否统一?
   - 粗体、斜体语法是否正确?
   - 引用块语法是否正确?
   - 代码块是否正确闭合?

4. **缩进和空行检查**:
   - 缩进是否一致?
   - 空行使用是否规范?
   - 是否有多余的空白字符?

## 输出格式

### 格式审阅报告

#### 语法正确性
- 评分:[A/B/C/D]
- 语法错误:[列表,含行号]

#### 格式一致性
- 评分:[A/B/C/D]
- 不一致处:[列表]

#### 需修正项
| 行号 | 问题类型 | 原内容 | 建议修正 |
|------|----------|--------|----------|
| ... | ... | ... | ... |

Agent 3: Density Review Expert

Task 工具参数:
- subagent_type: "general-purpose"
- run_in_background: true
- prompt:

你是一个slides内容密度审阅专家。请逐页检查内容密度。

## Slides内容
[插入presentation.md内容]

## 密度标准

| 指标 | 安全值 | 警告值 | 危险值 |
|------|--------|--------|--------|
| 每页文字行数 | ≤6行 | 7-8行 | >8行 |
| 每行字符数 | ≤35字符 | 36-45字符 | >45字符 |
| 列表项数量 | ≤5项 | 6项 | >6项 |
| 嵌套列表深度 | 1层 | 2层 | >2层 |
| 段落长度 | ≤2行 | 3行 | >3行 |

## 审阅任务

逐页分析:
1. 统计每页的文字行数
2. 检查最长行的字符数
3. 统计列表项数量
4. 检查是否有过长段落
5. 评估整体视觉密度

## 输出格式

### 密度审阅报告

#### 逐页密度分析

| 页码 | 行数 | 最长行 | 列表项 | 密度评级 | 状态 |
|------|------|--------|--------|----------|------|
| 1 | X | X字符 | X项 | 低/中/高 | ✓/⚠/✗ |
| 2 | ... | ... | ... | ... | ... |

#### 高密度页面(需处理)
- 第X页:[问题描述],建议:[拆分/精简/重组]
- ...

#### 拆分建议
对于需要拆分的页面,提供具体拆分方案:
- 第X页 → 拆分为 X-1 和 X-2
  - X-1 内容:...
  - X-2 内容:...

Agent 4: Visual Review Expert

Task 工具参数:
- subagent_type: "general-purpose"
- run_in_background: true
- prompt:

你是一个slides视觉设计审阅专家。请检查视觉层次和设计规范。

## Slides内容
[插入presentation.md内容]

## 审阅任务

1. **标题层次检查**:
   - 每页是否有清晰的标题?
   - 标题层级使用是否合理?
   - h1用于分隔页,h2用于内容页?

2. **强调元素检查**:
   - 粗体是否用于关键词/要点?
   - 引用块是否用于重要引语?
   - 强调是否过度(全篇都是粗体)?

3. **视觉焦点检查**:
   - 每页是否有明确的视觉焦点?
   - 信息层次是否清晰?
   - 是否有页面过于平淡或过于杂乱?

4. **一致性检查**:
   - 相似内容的页面格式是否统一?
   - 列表符号是否一致?
   - 整体风格是否协调?

## 输出格式

### 视觉审阅报告

#### 标题层次
- 评分:[A/B/C/D]
- 问题页面:[列表]

#### 强调使用
- 评分:[A/B/C/D]
- 改进建议:[列表]

#### 视觉焦点
- 评分:[A/B/C/D]
- 需优化页面:[列表]

#### 一致性
- 评分:[A/B/C/D]
- 不一致处:[列表]

#### 需修改页面清单
| 页码 | 问题 | 建议 |
|------|------|------|
| ... | ... | ... |

Aggregate Review Results:

Use the TaskOutput tool to collect the reports from the 4 agents and integrate them into a unified review report.

File Saving:

  • Content Review Report:slides_[项目名]/03_reviews/content-review.md
  • Format Review Report:slides_[项目名]/03_reviews/format-review.md
  • Density Review Report:slides_[项目名]/03_reviews/density-review.md
  • Visual Review Report:slides_[项目名]/03_reviews/visual-review.md
  • Comprehensive Review Report:slides_[项目名]/03_reviews/summary.md

Comprehensive Review Report Template (03_reviews/summary.md):

## 综合审阅报告

### 各维度评分

| 维度 | 评分 | 主要问题 |
|------|------|----------|
| 内容 | [A-D] | [概述] |
| 格式 | [A-D] | [概述] |
| 密度 | [A-D] | [概述] |
| 视觉 | [A-D] | [概述] |

### 需修改页面汇总

[按页码整合所有agent的修改建议]

### 优先处理项

1. [最重要的问题]
2. [次重要的问题]
...

Output: Comprehensive review report, a revision list arranged by priority

Phase Three B: Chinese Language Standards Review (Chinese presentations only)

Trigger: After the multi-dimensional review is completed, execute this phase if it is a Chinese presentation

Execution Method: Use the Task tool to dispatch a subagent for execution

Subagent Invocation Instruction:

使用 Task 工具,设置 subagent_type="general-purpose",prompt 内容如下:

你是一个中文语言规范专家。请对以下Marp Slides进行逐页审阅,确保符合中文书写规范和演示文稿语言习惯:

[插入 slides_[项目名]/02_drafts/presentation.md 的内容]

审阅要求:

1. **标点符号检查**:
   - 必须使用中文标点:。,?!:;“” ‘’()……——
   - 禁止使用英文标点:. , ? ! : ; ""'' () ... --
   - 列表项末尾可省略句号
   - 标题末尾不加标点

2. **引号使用规范**(重要):
   - 原则:Slides中能不用引号就不用,让文字更简洁
   - 删除不必要的引号,例如:
     - ✗ 这就是所谓的"核心概念" → ✓ 这就是核心概念
     - ✗ AI的"智能"表现 → ✓ AI的智能表现
   - 仅在以下情况保留引号:
     - 直接引语(如:他说:"……")
     - 表示反讽或特殊含义
     - 专有名词首次出现且需要解释

3. **语言习惯检查**:
   - 避免欧化句式(如"被"字句滥用)
   - 避免翻译腔
   - 删除冗余表达(Slides需要极简文字)
   - 使用自然的中文表达顺序
   - 避免长句,每个要点保持简短

4. **中英文混排规范**:
   - 中文与英文/数字之间加空格(如:Claude Code 是工具)
   - 全角标点与英文之间不加空格
   - 技术术语保持一致(如:API、SDK 等全文统一)

5. **Slides特有检查**:
   - 标题是否简洁有力
   - 要点是否用词精准
   - 是否避免了口语化表达
   - 专业术语是否一致

输出格式:

## 中文规范审阅报告

### 标点符号修正
| 页码 | 原文 | 修正后 |
|------|------|--------|
| ... | ... | ... |

### 引号精简
| 页码 | 修改内容 |
|------|----------|
| ... | 删除"xxx"的引号 |

### 表达优化
| 页码 | 原表达 | 优化后 |
|------|--------|--------|
| ... | ... | ... |

### 中英文混排修正
| 页码 | 原文 | 修正后 |
|------|------|--------|
| ... | ... | ... |

### 修正后的完整Slides
[输出完成所有修正的Slides内容]

File Saving:

  • Chinese Standards Review Report:slides_[项目名]/03_reviews/chinese-review.md

Follow-up Processing:

  • After receiving the review report returned by the subagent, use the Edit tool to apply the corrections to slides_[项目名]/02_drafts/presentation.md
  • Pass the corrected Slides to Phase Four

Phase Four: PNG Conversion and Parallel Inspection

Trigger: After review revisions are completed

Execution Steps:

  1. Convert to PNG:

    # 从02_drafts读取初稿,导出到04_exports
    marp slides_[项目名]/02_drafts/presentation.md -o slides_[项目名]/04_exports/slides.html --html
    marp slides_[项目名]/02_drafts/presentation.md --images png -o slides_[项目名]/04_exports/
    
  2. Deploy Agents in Parallel for Inspection: Use the Task tool to dispatch multiple subagents in parallel, each checking one group of pages:

    使用 Task 工具,设置 subagent_type="general-purpose",run_in_background=true
    
    派遣多个agents(根据总页数,每个agent检查3-5页):
    
    Agent 1: 检查第1-5页
    Agent 2: 检查第6-10页
    Agent 3: 检查第11-15页
    ...
    
    每个Agent的prompt:
    
    你是一个slides视觉质量检查专家。请检查以下PNG图片:
    
    [使用Read工具读取 slides_[项目名]/04_exports/ 中对应的PNG文件]
    
    检查要点:
    1. 文字是否超出页面边界?
    2. 内容是否过于拥挤?
    3. 文字是否过小难以阅读?
    4. 布局是否平衡?
    5. 是否有明显的格式问题?
    
    输出格式:
    ## 页面检查报告
    
    ### 第X页
    - 状态:通过 / 需修改
    - 问题:[问题描述]
    - 建议:[修改建议,如"拆分为两页"或"精简第3个要点"]
    
  3. Aggregate Inspection Results: Use the TaskOutput tool to collect the reports from all agents

File Save Location:

  • HTML Preview:slides_[项目名]/04_exports/slides.html
  • PNG Images:slides_[项目名]/04_exports/presentation.001.png, presentation.002.png, ...

Phase Five: Issue Fixing and Final Draft Confirmation

Trigger: Receive all page inspection reports

Execution Steps:

  1. Issue Classification:

    • Overflow Issues: Text exceeds the page → split the page or streamline the content
    • Density Issues: Too much content → delete or reorganize
    • Format Issues: Layout errors → correct Markdown
    • Readability Issues: Text too small/too dense → adjust the hierarchy
  2. Fix one by one: Use the Edit tool to modify slides_[项目名]/02_drafts/presentation.md, for each issue:

    • Page-splitting strategy: Split one page into an "overview page" + "details page"
    • Simplification strategy: Remove secondary information, keep the core
    • Reorganization strategy: Adjust the information hierarchy and use a more appropriate page type
  3. Re-verify:

    • Convert again to PNG to 04_exports/
    • Quickly check the modified pages
    • Confirm the issues have been resolved
  4. Generate final draft: Copy the fixed file to 05_final/ and export the final version:

    # 复制终稿Markdown
    cp slides_[项目名]/02_drafts/presentation.md slides_[项目名]/05_final/presentation.md
    
    # 导出最终HTML(带自定义主题)
    npx @marp-team/marp-cli slides_[项目名]/05_final/presentation.md -o slides_[项目名]/05_final/slides.html --html --theme-set ./themes/
    
  5. Export multi-format versions:

    Use marp-cli to export PDF and PowerPoint formats:

    # 导出 PDF 版本
    npx @marp-team/marp-cli slides_[项目名]/05_final/presentation.md -o slides_[项目名]/05_final/slides.pdf --theme-set ./themes/ --allow-local-files
    
    # 导出可编辑的 PowerPoint (PPTX) 版本
    npx @marp-team/marp-cli slides_[项目名]/05_final/presentation.md -o slides_[项目名]/05_final/slides.pptx --pptx-editable --theme-set ./themes/ --allow-local-files
    

    Export instructions:

    • --allow-local-files: Allow loading local images and resources
    • --theme-set ./themes/: Load the custom theme directory
    • --pptx-editable: Export editable PPTX (requires LibreOffice installed on the system)
    • PDF is suitable for printing and distribution
    • PPTX is suitable for further editing in PowerPoint/Keynote

    Note:--pptx-editable requires LibreOffice Impress to be installed on the system. If not installed, you can install it using Homebrew:

    brew install --cask libreoffice
    
  6. Update project README: Update slides_[项目名]/README.md progress, and mark all stages as complete.

Final draft file locations:

  • Final Markdown:slides_[项目名]/05_final/presentation.md
  • HTML version:slides_[项目名]/05_final/slides.html
  • PDF version:slides_[项目名]/05_final/slides.pdf
  • PowerPoint version:slides_[项目名]/05_final/slides.pptx

Output: Final draft file paths (including HTML, PDF, and PPTX formats) and production summary

Common issue handling

Text overflow

Cause: Too much content on a single page

Solution:

  1. Split method: Split the content into multiple pages

    ## 原始页面:五个要点
    
    拆分为:
    
    ## 要点概览(1/2)
    1. 要点一
    2. 要点二
    3. 要点三
    
    ---
    
    ## 要点概览(2/2)
    4. 要点四
    5. 要点五
    
  2. Simplification method: Remove secondary information

  3. Hierarchy method: Use sublists to shorten the main list

Code block too long

Solution:

  • Show only key code snippets
  • Use pseudocode instead of complete code
  • Display across multiple pages, one logical unit per page

Table too large

Solution:

  • Split into multiple small tables
  • Convert to list format
  • Show only key data rows

Template usage instructions

Template file marp-template.md includes:

  • graph_paper theme configuration
  • Chinese font support
  • Blue quote block style
  • Examples of multiple page types

Modify Header/Footer:

header: '你的课程/演讲标题'
footer: "讲座标题 | 机构名称"

Resource references

Reference files

  • marp-template.md - Marp template file
  • references/slide-types.md - Detailed explanation of page types
  • references/review-checklist.md - Review checklist
  • themes/README.md - Theme documentation
  • themes/*.css - 14 selected theme files

Marp-CLI command reference

# 预览初稿(启动本地服务器,加载自定义主题)
npx @marp-team/marp-cli -s slides_[项目名]/02_drafts/presentation.md --theme-set ./themes/

# 导出初稿到04_exports(使用自定义主题)
npx @marp-team/marp-cli slides_[项目名]/02_drafts/presentation.md -o slides_[项目名]/04_exports/slides.html --html --theme-set ./themes/
npx @marp-team/marp-cli slides_[项目名]/02_drafts/presentation.md --images png -o slides_[项目名]/04_exports/ --theme-set ./themes/

# 导出终稿到05_final(HTML)
npx @marp-team/marp-cli slides_[项目名]/05_final/presentation.md -o slides_[项目名]/05_final/slides.html --html --theme-set ./themes/

# 导出终稿 PDF 版本
npx @marp-team/marp-cli slides_[项目名]/05_final/presentation.md -o slides_[项目名]/05_final/slides.pdf --theme-set ./themes/ --allow-local-files

# 导出终稿可编辑 PowerPoint (PPTX) 版本
npx @marp-team/marp-cli slides_[项目名]/05_final/presentation.md -o slides_[项目名]/05_final/slides.pptx --pptx-editable --theme-set ./themes/ --allow-local-files

Parameter description:

Parameter Description
--theme-set ./themes/ Load all themes in the local themes folder
--allow-local-files Allow loading local images and resources (required for PDF/PPTX export)
--pptx-editable Export editable PPTX (requires LibreOffice)
--html Enable HTML tag support
-s Start preview server
--images png Export as PNG image sequence

Export Format Description:

Format Purpose File Extension
HTML Web display, online sharing .html
PDF Printing, formal distribution .pdf
PPTX PowerPoint/Keynote editing .pptx
PNG Image preview, quality check .001.png, .002.png, ...

Interaction Guidelines

  1. After each stage ends, ask the user whether to continue
  2. After content analysis, have the user confirm the outline before continuing
  3. When issues are found during inspection, explain the issues and the suggested fixes
  4. When providing options, give a recommended option and the reason

Prohibitions

  • Do not skip content analysis and directly create slides
  • Do not place too much content on a single page
  • Do not use overly small fonts or overly dense layout
  • Do not ignore PNG inspection results
  • Do not output an unverified final draft