agentsclimarketplace

Marp slides creator

Skill brycewang-stanford/Auto-Empirical-Research-Skills/skills/67-econfin-workflow-toolkit/marp-slides-creator

🔬 A curated collection of 23,000+ agent skills for empirical research across 8 social science disciplines. | 精选 23,000+ AI Agent 技能库,覆盖8大社会科学学科的实证研究。CoPaper.AI 20分钟完成一篇可复现的规范实证论文,并支持用户上传 Skills。-- Maintained by CoPaper.AI from Stanford REAP.

Install
npx -y skills add brycewang-stanford/Auto-Empirical-Research-Skills --skill marp-slides-creator

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.

What its author says it does

Copied from the file, not written here

专业Marp演示文稿制作助手。支持完整工作流程:工作空间初始化、内容分析、slides制作、多维度审阅、中文语言规范审阅(中文演示文稿)、PNG转换检查、终稿确定。所有产出物集中管理在项目工作文件夹中。当用户提到"制作slides"、"做PPT"、"演示文稿"、"Marp"、"幻灯片"、"presentation"等关键词时自动启用。Professional Marp presentation assistant with complete workflow: workspace initialization, content analysis, slide creation, multi-dimensional review, Chinese language review (for Chinese presentations), PNG conversion check, and finalization. All outputs organized in project workspace.

SKILL.md

26.8 KB, as published. Nobody here has run it

Marp Slides 制作助手

技能概述

本技能提供系统性多阶段Marp演示文稿制作流程,从工作空间初始化到终稿输出。对于中文演示文稿,额外包含中文语言规范审阅阶段。所有分析报告、初稿、审阅文档、PNG导出和终稿统一保存在项目工作文件夹中,便于管理和追溯。

支持多种主题风格:内置 14 款精选主题,涵盖学术、商务、创意等场景。详见 themes/README.md

核心原则

Slides设计原则

原则说明要点
一页一点每页只讲一个核心观点避免信息过载
视觉层次标题→要点→细节使用粗体、列表、引用区分
留白充足内容不超过页面60%给观众呼吸空间
文字精简每页文字不超过8行关键词优于完整句子

内容密度控制

  • 标题页:主标题 + 副标题 + 作者信息
  • 内容页:标题 + 3-5个要点(每点1-2行)
  • 对比页:两栏对比,每栏不超过4点
  • 总结页:3-5个核心要点

七阶段工作流程

严格按照以下流程执行,每阶段结束后询问用户确认:

阶段零:工作空间初始化与主题选择(预处理)

触发:用户请求制作slides时立即执行

执行步骤

  1. 确定项目名称

    • 根据用户提供的主题/文件名确定项目名称
    • 使用简短的英文或拼音命名,用连字符连接
    • 示例:academic-writingai-introductionproduct-launch
  2. 创建工作文件夹结构

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

    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. 主题选择

    使用 AskUserQuestion 工具让用户选择主题风格:

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

    可用主题列表(按场景分类):

    场景主题选项
    学术答辩academic, beam, zju
    技术分享graph_paper, beam, turing
    产品发布jobs, gradient
    企业汇报companyLightBlue, companySZ
    教学演示simple, graph_paper, academic
    创意展示gradient, jobs, socrates

    主题文件位置themes/ 目录下所有 .css 文件

  5. 创建README.md

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

输出:工作文件夹路径、选择的主题名称,告知用户所有产出物将保存在此文件夹中


阶段一:内容分析与消化

触发:工作空间创建完成后,用户提供输入文件(PDF、论文、文档、笔记等)

执行步骤

  1. 初步阅读:使用 Read 工具读取输入文件,了解整体结构
  2. 深度分析
    • 提取核心论点和关键信息
    • 识别逻辑结构(问题-方案-结论 / 现状-分析-建议 等)
    • 标记重要数据、引用、案例
  3. 内容分类
    • 核心观点(必须包含)
    • 支撑证据(选择性包含)
    • 背景信息(简化或省略)
  4. 大纲生成
    • 确定slides数量(建议10-20页)
    • 规划每页主题和内容密度
    • 设计叙事流程

文件保存

  • 内容分析报告:slides_[项目名]/01_analysis/content-analysis.md
  • Slides大纲:slides_[项目名]/01_analysis/outline.md

输出模板

01_analysis/content-analysis.md:

## 内容分析报告

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

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

01_analysis/outline.md:

## Slides大纲(预计X页)

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

阶段二:Slides初稿制作

触发:用户确认内容分析和大纲

执行步骤

  1. 读取模板:使用 Read 工具读取 marp-template.md

  2. 应用主题

    • 在 YAML frontmatter 中设置用户选择的主题:
      ---
      marp: true
      theme: [用户选择的主题名]
      ---
      
    • 不同主题可能支持特殊的 class,参考 themes/README.md
  3. 主题适配(自动调整)

    不同主题对标题格式有不同要求,制作 slides 时必须根据主题自动调整:

    主题内容页标题格式说明
    beam# (h1)h1 显示在顶部蓝色条中
    academic# (h1)h1 用于页面标题
    jobs# (h1)h1 有特殊下划线样式
    graph_paper## (h2)标准 h2 标题
    simple## (h2)标准 h2 标题
    其他主题## (h2)默认使用 h2

    beam 主题特殊处理

    • 每页第一个 # (h1) 会自动显示在顶部蓝色装饰条中
    • 标题页使用 <!-- _class: title --> 指令
    • 内容页直接使用 # 标题(不是 ##
    • 示例:
      ---
      # 页面标题在蓝色条中
      
      正文内容...
      

    academic/jobs 主题特殊处理

    • 同样使用 # (h1) 作为页面标题
    • 支持 class: lead 用于特殊页面
  4. 必须包含居中样式:frontmatter 的 style 中必须包含以下 CSS,否则图片和表格会左对齐:

    /* 图片居中 */
    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;
    }
    

    原因:Marp 基础 CSS 设置 section table { display: block; width: max-content },多数自定义主题又设置 table { width: 100% },两者都会导致表格无法居中。必须用 !important 同时覆盖 displaywidthmargin 三个属性才能生效。marp-template.md 已包含这些样式。

  5. 修改Header/Footer:根据演讲主题调整

  6. 逐页制作

    • 遵循模板中的页面类型和格式
    • 每页严格控制内容量
    • 使用适当的Markdown格式(粗体、引用、列表)

页面类型选择(参考 references/slide-types.md):

  • 标题页:开场
  • 目录页:内容预告
  • 单点页:核心观点展示
  • 列表页:多要点展示
  • 对比页:两种观点/方案对比
  • 引用页:重要引用展示
  • 分隔页:章节过渡
  • 总结页:要点回顾

文件保存

  • 保存初稿:slides_[项目名]/02_drafts/presentation.md
  • 更新README.md中的进度状态

阶段三:多维度并行审阅

触发:初稿完成后自动进入

执行方式:使用 Task 工具并行派遣4个专业agent,每个负责一个审阅维度

并行Agent部署

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

Agent 1:内容审阅专家

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:格式审阅专家

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:密度审阅专家

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:视觉审阅专家

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]
- 不一致处:[列表]

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

汇总审阅结果

使用 TaskOutput 工具收集4个agent的报告,整合为统一的审阅报告。

文件保存

  • 内容审阅报告:slides_[项目名]/03_reviews/content-review.md
  • 格式审阅报告:slides_[项目名]/03_reviews/format-review.md
  • 密度审阅报告:slides_[项目名]/03_reviews/density-review.md
  • 视觉审阅报告:slides_[项目名]/03_reviews/visual-review.md
  • 综合审阅报告:slides_[项目名]/03_reviews/summary.md

综合审阅报告模板 (03_reviews/summary.md):

## 综合审阅报告

### 各维度评分

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

### 需修改页面汇总

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

### 优先处理项

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

输出:综合审阅报告,按优先级排列的修改清单

阶段三B:中文语言规范审阅(仅中文演示文稿)

触发:多维度审阅完成后,如果是中文演示文稿则执行此阶段

执行方式:使用 Task 工具派遣 subagent 执行

Subagent 调用指令

使用 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内容]

文件保存

  • 中文规范审阅报告:slides_[项目名]/03_reviews/chinese-review.md

后续处理

  • 收到 subagent 返回的审阅报告后,使用 Edit 工具将修正应用到 slides_[项目名]/02_drafts/presentation.md
  • 将修正后的Slides传递给阶段四

阶段四:PNG转换与并行检查

触发:审阅修改完成后

执行步骤

  1. 转换为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. 并行部署Agents检查: 使用 Task 工具并行派遣多个 subagent,每个检查一组页面:

    使用 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. 汇总检查结果:使用 TaskOutput 工具收集所有agent的报告

文件保存位置

  • HTML预览:slides_[项目名]/04_exports/slides.html
  • PNG图片:slides_[项目名]/04_exports/presentation.001.png, presentation.002.png, ...

阶段五:问题修复与终稿确定

触发:收到所有页面检查报告

执行步骤

  1. 问题分类

    • 溢出问题:文字超出页面 → 拆分页面或精简内容
    • 密度问题:内容过多 → 删减或重组
    • 格式问题:排版错误 → 修正Markdown
    • 可读性问题:字太小/太密 → 调整层次
  2. 逐一修复: 使用 Edit 工具修改 slides_[项目名]/02_drafts/presentation.md,针对每个问题:

    • 拆页策略:将一页拆为"概述页"+"详情页"
    • 精简策略:删除次要信息,保留核心
    • 重组策略:调整信息层次,使用更合适的页面类型
  3. 重新验证

    • 再次转换为PNG到 04_exports/
    • 快速检查修改后的页面
    • 确认问题已解决
  4. 生成终稿: 将修复后的文件复制到 05_final/ 并导出最终版本:

    # 复制终稿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. 导出多格式版本

    使用 marp-cli 导出 PDF 和 PowerPoint 格式:

    # 导出 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
    

    导出说明

    • --allow-local-files:允许加载本地图片和资源
    • --theme-set ./themes/:加载自定义主题目录
    • --pptx-editable:导出可编辑的 PPTX(需要系统安装 LibreOffice)
    • PDF 适合打印和分发
    • PPTX 适合在 PowerPoint/Keynote 中进一步编辑

    注意--pptx-editable 需要系统安装 LibreOffice Impress。如未安装,可使用 Homebrew 安装:

    brew install --cask libreoffice
    
  6. 更新项目README: 更新 slides_[项目名]/README.md 中的进度,标记所有阶段为完成。

终稿文件位置

  • 最终Markdown:slides_[项目名]/05_final/presentation.md
  • HTML版本:slides_[项目名]/05_final/slides.html
  • PDF版本:slides_[项目名]/05_final/slides.pdf
  • PowerPoint版本:slides_[项目名]/05_final/slides.pptx

输出:终稿文件路径(包含 HTML、PDF、PPTX 三种格式)和制作摘要

常见问题处理

文字溢出

原因:单页内容过多

解决方案

  1. 拆分法:将内容拆分为多页

    ## 原始页面:五个要点
    
    拆分为:
    
    ## 要点概览(1/2)
    1. 要点一
    2. 要点二
    3. 要点三
    
    ---
    
    ## 要点概览(2/2)
    4. 要点四
    5. 要点五
    
  2. 精简法:删除次要信息

  3. 层次法:使用子列表缩短主列表

代码块过长

解决方案

  • 只展示关键代码片段
  • 使用伪代码替代完整代码
  • 分多页展示,每页一个逻辑单元

表格过大

解决方案

  • 拆分为多个小表格
  • 转换为列表形式
  • 只展示关键数据行

模板使用说明

模板文件 marp-template.md 包含:

  • graph_paper主题配置
  • 中文字体支持
  • 蓝色引用块样式
  • 多种页面类型示例

修改Header/Footer

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

资源引用

参考文件

  • marp-template.md - Marp模板文件
  • references/slide-types.md - 页面类型详解
  • references/review-checklist.md - 审阅检查清单
  • themes/README.md - 主题说明文档
  • themes/*.css - 14款精选主题文件

Marp-CLI 命令参考

# 预览初稿(启动本地服务器,加载自定义主题)
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

参数说明

参数说明
--theme-set ./themes/加载本地 themes 文件夹中的所有主题
--allow-local-files允许加载本地图片和资源(PDF/PPTX 导出必需)
--pptx-editable导出可编辑的 PPTX(需要 LibreOffice)
--html启用 HTML 标签支持
-s启动预览服务器
--images png导出为 PNG 图片序列

导出格式说明

格式用途文件扩展名
HTML网页展示、在线分享.html
PDF打印、正式分发.pdf
PPTXPowerPoint/Keynote 编辑.pptx
PNG图片预览、质量检查.001.png, .002.png, ...

交互规范

  1. 每阶段结束后询问用户是否继续
  2. 内容分析后让用户确认大纲再继续
  3. 检查发现问题时,说明问题和建议的修复方案
  4. 提供选择时给出推荐选项和理由

禁止事项

  • 不跳过内容分析直接制作slides
  • 不在单页放置过多内容
  • 不使用过小的字体或过密的排版
  • 不忽略PNG检查结果
  • 不输出未经验证的终稿

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.