agentpreso

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

AgentPreso — AI-Native Presentations

AgentPreso — 原生AI演示文稿工具

Create professional slide decks from markdown with charts, diagrams, AI-generated graphics, and 10 built-in themes.

从Markdown创建带有图表、图形、AI生成图片和10种内置主题的专业演示文档。

Quick Start

快速开始

bash

undefined

bash

undefined

1. Install the CLI

1. 安装CLI

curl -fsSL https://agentpreso.com/install.sh | sh

2. Authenticate

2. 身份验证

agentpreso login

3. Create a deck (generates a markdown file from the theme scaffold)

3. 创建演示文档（从主题模板生成Markdown文件）

agentpreso create my-deck --theme glacier

4. Push to cloud

4. 推送至云端

agentpreso push my-deck.md

5. Render to PDF

5. 渲染为PDF

agentpreso render my-deck.md --format pdf

undefined

agentpreso render my-deck.md --format pdf

undefined

When to Use

使用场景

Activate this skill when the user wants to:

Create slides, presentations, decks, or pitch decks
Add charts or diagrams to slides
Export slides to PDF or PPTX
Work with Marp markdown
Mentions AgentPreso by name
Needs a visual summary, report, or briefing in slide format

当用户有以下需求时，启用该工具：

创建幻灯片、演示文稿、演示文档或推介文档
为幻灯片添加图表或图形
将幻灯片导出为PDF或PPTX格式
使用Marp Markdown进行创作
提及AgentPreso名称
需要以幻灯片格式呈现可视化摘要、报告或简报

Markdown Format

Markdown格式

Decks are single

.md

files. Frontmatter sets metadata and theme:

markdown

---
marp: true
theme: glacier
title: My Presentation
---

<!-- _class: title-hero -->

演示文档为单个

.md

文件。Frontmatter用于设置元数据和主题：

markdown

---
marp: true
theme: glacier
title: My Presentation
---

<!-- _class: title-hero -->

Presentation Title

Subtitle or tagline

Subtitle or tagline

Key Points

First insight with supporting detail
Second insight with data
Third insight with takeaway

First insight with supporting detail
Second insight with data
Third insight with takeaway

Comparison

::left::

Option A Description of the first option.

::right::

Option B Description of the second option.


**Key syntax:**
- `---` separates slides
- `<!-- _class: layout-name -->` sets a slide layout
- `::left::`, `::right::`, `::center::` mark columns
- `<!-- _class: invert -->` enables dark mode on a slide
- `{{variable}}` template variables replaced at render time
- `asset://filename.png` references uploaded images
- Chart blocks: `` ```chart `` with YAML (type, labels, datasets)
- Diagram blocks: `` ```mermaid `` with Mermaid syntax
- AI images: `` ```generated_image `` with a text prompt

::left::

Option A Description of the first option.

::right::

Option B Description of the second option.


**核心语法：**
- `---` 分隔幻灯片
- `<!-- _class: layout-name -->` 设置幻灯片布局
- `::left::`, `::right::`, `::center::` 标记分栏
- `<!-- _class: invert -->` 为单张幻灯片启用深色模式
- `{{variable}}` 模板变量会在渲染时被替换
- `asset://filename.png` 引用已上传的图片
- 图表块：`` ```chart `` 搭配YAML（类型、标签、数据集）
- 图形块：`` ```mermaid `` 使用Mermaid语法
- AI生成图片：`` ```generated_image `` 搭配文本提示

Available Themes

可用主题

Theme	Description
`agentpreso`	Navy & tangerine on warm ivory — the signature theme
`blueprint`	Technical, precise, engineering-focused
`botanica`	Nature-inspired, organic, warm greens
`chalk`	Blackboard-style, handwritten feel
`ember`	Warm, bold, fire-inspired gradients
`glacier`	Cool blues, icy, clean, corporate
`ink`	High-contrast black & white, editorial
`maison`	Elegant, luxury, sophisticated serif
`neon`	Vibrant, futuristic, dark with bright accents
`terminal`	Monospace, developer-focused, green on black

主题	描述
`agentpreso`	暖象牙色底色搭配藏青与橘色——标志性主题
`blueprint`	技术风、精准、面向工程领域
`botanica`	自然灵感、有机风格、暖绿色调
`chalk`	黑板风格、手写质感
`ember`	温暖、大胆、火焰灵感渐变
`glacier`	冷蓝色调、冰爽、简洁、商务风
`ink`	高对比度黑白、编辑风格
`maison`	优雅、奢华、精致衬线体
`neon`	活力、未来感、深色背景搭配亮色点缀
`terminal`	等宽字体、面向开发者、黑底绿字

Available Layouts

可用布局

Layout	Description
`title-hero`	Opening slide with large title and optional subtitle
`chapter`	Section divider with chapter title
`full-bleed-title`	Title over a full-bleed background image
`focus`	Single statement or key number, centered
`bullets`	Bullet list with automatic text fitting
`steps`	Numbered process or workflow steps
`stats-grid`	Grid of key metrics or statistics
`two-col`	Two equal columns side by side
`two-col-wide-right`	Two columns, right column wider
`three-col`	Three equal columns
`img-right`	Content left, image right
`img-left`	Image left, content right
`full-bleed`	Full-bleed image with overlaid text
`quote`	Blockquote with attribution
`summary`	Closing slide with key takeaways

布局	描述
`title-hero`	带有大标题和可选副标题的开场幻灯片
`chapter`	带有章节标题的分段分隔页
`full-bleed-title`	标题叠加全屏背景图
`focus`	单个核心观点或关键数据，居中显示
`bullets`	自动适配文本的项目符号列表
`steps`	编号流程或工作步骤
`stats-grid`	关键指标或统计数据网格
`two-col`	两等宽分栏
`two-col-wide-right`	两栏，右侧栏更宽
`three-col`	三等宽分栏
`img-right`	内容在左，图片在右
`img-left`	图片在左，内容在右
`full-bleed`	全屏图片叠加文本
`quote`	带署名的块引用
`summary`	包含核心要点的结尾幻灯片

Slide Design Principles

幻灯片设计原则

Every slide needs a visual — use charts, diagrams, images, or icons. Walls of text lose the audience.
Vary your layouts — alternate between bullets, two-col, img-right, stats-grid. Repetition is boring.
One idea per slide — if you have two points, make two slides. Density kills clarity.
Preview before you are done — render and review. Adjust text fitting, check image placement, verify chart readability.

每张幻灯片都需要视觉元素 —— 使用图表、图形、图片或图标。大段文字会失去观众注意力。
变换布局样式 —— 在项目符号、双栏、右图左文、统计网格等布局间切换。重复会显得乏味。
每张幻灯片一个核心观点 —— 如果有两个要点，就做两张幻灯片。内容过密会影响清晰度。
完成前预览 —— 渲染并审阅。调整文本适配，检查图片位置，验证图表可读性。

Review Strategy

审核策略

After creating a deck, preview every slide and review for quality. Two approaches:

Parallel (recommended when subagents are available): Spawn read-only subagents to review slide PNGs in parallel — one per slide or batch of 2-3. Each subagent checks the 3-second test, title quality, text density, visual presence, and layout fit, then reports findings as text. The parent agent collects findings, edits the

.md

file once, and re-previews only changed slides. See

commands/create-deck.md

for the full protocol.

Sequential (default): Review each slide preview yourself, fix issues, re-push, re-preview until satisfied.

创建完演示文档后，预览每张幻灯片并检查质量。有两种方法：

并行审核（推荐在有子Agent可用时使用）： 生成只读子Agent并行审阅幻灯片PNG——每张幻灯片或2-3张为一批。每个子Agent检查3秒测试、标题质量、文本密度、视觉元素和布局适配性，然后将结果以文本形式报告。父Agent收集结果，一次性编辑

.md

文件，仅重新预览修改过的幻灯片。完整流程请参阅

commands/create-deck.md

。

串行审核（默认）： 自行审阅每张幻灯片预览，修复问题，重新推送，重新预览直至满意。

Reference Files

参考文件

Read these on demand for detailed guidance:

File	Contents
`references/cli-reference.md`	Full CLI command reference
`references/mcp-tools.md`	MCP tool reference
`references/slide-layouts.md`	Layout examples and usage
`references/themes.md`	Theme details and customization
`references/charts-diagrams.md`	Chart and diagram syntax
`references/custom-themes.md`	Creating custom themes
`references/markdown-format.md`	Complete markdown syntax
`references/export-formats.md`	Export format details
`references/presentation-craft.md`	Slide design best practices
`references/brand-logos.md`	Logo placement and branding

按需阅读以下文件获取详细指导：

文件	内容
`references/cli-reference.md`	完整CLI命令参考
`references/mcp-tools.md`	MCP工具参考
`references/slide-layouts.md`	布局示例与使用方法
`references/themes.md`	主题详情与自定义
`references/charts-diagrams.md`	图表与图形语法
`references/custom-themes.md`	自定义主题创建
`references/markdown-format.md`	完整Markdown语法
`references/export-formats.md`	导出格式详情
`references/presentation-craft.md`	幻灯片设计最佳实践
`references/brand-logos.md`	Logo放置与品牌规范

Examples

示例

See the

examples/

directory for complete, valid AgentPreso markdown files demonstrating themes, layouts, charts, and diagrams.

请查看

examples/

目录下完整、有效的AgentPreso Markdown文件，这些文件展示了主题、布局、图表和图形的使用方法。