PPT Layout Matcher
Intelligent layout matching for PowerPoint presentations based on a 45-page professional design layout library.
When to Use
- User wants to create a PPT from content
- User asks "which layout should I use for this content?"
- User provides bullet points / data / flow descriptions and wants them turned into slides
- User mentions "PPT", "presentation", "slides", "版式", "排版"
Workflow
Step 1: Analyze Content Structure
Extract key features from user input:
- Number of items (3 key metrics? 4 steps? 2 comparisons?)
- Content nature (data/metrics, process/steps, comparison, gallery, list)
- Presence of numbers/charts/images
- Timeline/step indicators
Step 2: Run Matching Algorithm
Execute the bundled script to get layout recommendations:
python3 ppt_layout_matcher.py
Or use the Python API:
from ppt_layout_matcher import recommend_layout
results = recommend_layout("user content here", top_k=3)
for template, score, analysis in results:
print(f"{template.name} (Slide {template.slide_ref}) - Score: {score}")
Step 3: Present Top 3 to User
Show:
- Layout name and reference slide number
- Match score
- Structure description
- Why this layout was recommended
Let the user confirm before creating.
Step 4: Create PPT with python-pptx
Once confirmed, create the slide:
- 16:9 dimensions (13.33" × 7.50")
- Dark theme (deep blue/gray background)
- White text, accent colors for data highlights
- Follow the reference layout structure from
references/layout_templates.md
Step 5: QA
Verify with markitdown:
python -m markitdown output.pptx | head -100
Layout Categories (Quick Reference)
| Category |
Count |
Use Case |
| A-Cover |
2 |
Report cover, proposal front page |
| B-Divider |
2 |
Section transitions |
| C-Data Display |
9 |
Metrics, charts, data highlights |
| D-Process/Steps |
6 |
STEP flows, development stages |
| E-Comparison |
5 |
A/B comparison, multi-solution, SWOT |
| F-Grid/Cards |
8 |
2×2, 3×2, 4×N card grids |
| G-Gallery |
1 |
Image gallery, timeline |
| H-List/Points |
4 |
Numbered lists, text+image lists |
| I-Infographic |
1 |
One Pager overview |
| J-Special |
7 |
Radial, wraparound, mixed layouts |
Design Conventions
- Title bar: top 0.3-1.0" area
- Content area: 1.2"-7.0"
- Footer: 6.5"-7.2"
- Margins: ≥0.5" on all sides
- Heading: 20-30pt Bold, Body: 10-14pt, Big Numbers: 36-60pt Bold
- Dark background, white text, accent colors for highlights
References
Full layout library documentation: references/layout_templates.md
1---2name: ppt-layout-matcher3description: Intelligent PPT layout matching system based on a 45-page design layout library (16:9). Analyzes input content and automatically recommends the best slide layout from 10 categories. Trigger when user says: "做PPT", "创建PPT", "生成PPT", "版式匹配", "选版式", "PPT排版", or provides content that needs to be turned into presentation slides. Core capability: analyze content → match layout → create slides with python-pptx.4---56# PPT Layout Matcher78Intelligent layout matching for PowerPoint presentations based on a 45-page professional design layout library.910## When to Use1112- User wants to create a PPT from content13- User asks "which layout should I use for this content?"14- User provides bullet points / data / flow descriptions and wants them turned into slides15- User mentions "PPT", "presentation", "slides", "版式", "排版"1617## Workflow1819### Step 1: Analyze Content Structure2021Extract key features from user input:22- Number of items (3 key metrics? 4 steps? 2 comparisons?)23- Content nature (data/metrics, process/steps, comparison, gallery, list)24- Presence of numbers/charts/images25- Timeline/step indicators2627### Step 2: Run Matching Algorithm2829Execute the bundled script to get layout recommendations:3031```bash32python3 ppt_layout_matcher.py33```3435Or use the Python API:3637```python38from ppt_layout_matcher import recommend_layout39results = recommend_layout("user content here", top_k=3)40for template, score, analysis in results:41 print(f"{template.name} (Slide {template.slide_ref}) - Score: {score}")42```4344### Step 3: Present Top 3 to User4546Show:47- Layout name and reference slide number48- Match score49- Structure description50- Why this layout was recommended5152Let the user confirm before creating.5354### Step 4: Create PPT with python-pptx5556Once confirmed, create the slide:57- 16:9 dimensions (13.33" × 7.50")58- Dark theme (deep blue/gray background)59- White text, accent colors for data highlights60- Follow the reference layout structure from `references/layout_templates.md`6162### Step 5: QA6364Verify with markitdown:65```bash66python -m markitdown output.pptx | head -10067```6869## Layout Categories (Quick Reference)7071| Category | Count | Use Case |72|----------|:-----:|----------|73| A-Cover | 2 | Report cover, proposal front page |74| B-Divider | 2 | Section transitions |75| C-Data Display | 9 | Metrics, charts, data highlights |76| D-Process/Steps | 6 | STEP flows, development stages |77| E-Comparison | 5 | A/B comparison, multi-solution, SWOT |78| F-Grid/Cards | 8 | 2×2, 3×2, 4×N card grids |79| G-Gallery | 1 | Image gallery, timeline |80| H-List/Points | 4 | Numbered lists, text+image lists |81| I-Infographic | 1 | One Pager overview |82| J-Special | 7 | Radial, wraparound, mixed layouts |8384## Design Conventions8586- Title bar: top 0.3-1.0" area87- Content area: 1.2"-7.0"88- Footer: 6.5"-7.2"89- Margins: ≥0.5" on all sides90- Heading: 20-30pt Bold, Body: 10-14pt, Big Numbers: 36-60pt Bold91- Dark background, white text, accent colors for highlights9293## References9495Full layout library documentation: `references/layout_templates.md`
Lord1Egypt