slides-generator Create Hummingbot-branded presentation slides in PDF format from markdown content. Features two-column layouts and Mermaid diagram rendering for technical architecture and flowcharts. Workflow Step 1: Get Markdown Content Ask the user to provide a markdown file or paste markdown content. The content should follow this format:
Presentation Title
- First Slide Title Content for the first slide. Can include: - Bullet points - ** Bold text ** and * italic text * - Code blocks
- Second Slide Title More content here.
- Third Slide Title And so on... Format Rules:
Title
= Presentation title (optional, becomes title slide)
N. Slide Title
= New slide (N is slide number) Content under each
heading becomes slide content
Supports markdown formatting: lists, bold, italic, code blocks, links
Step 2: Parse and Confirm
Before generating the PDF, parse the markdown and show the user a summary:
📊 Slide Outline:
1. First Slide Title
2. Second Slide Title
3. Third Slide Title
...
Total: X slides
Please confirm to proceed with PDF generation, or provide edits.
Wait for user confirmation before proceeding.
Step 3: Generate PDF
Run the generation script:
bash
<
(
curl
-s
https://raw.githubusercontent.com/hummingbot/skills/main/skills/slides-generator/scripts/generate_slides.sh
)
\
--input
"
Save content to temp file
cat
/tmp/slides_content.md << 'SLIDES_EOF'
SLIDES_EOF
Generate PDF
bash
<
(
curl
-s
https://raw.githubusercontent.com/hummingbot/skills/main/skills/slides-generator/scripts/generate_slides.sh
)
\
--input
/tmp/slides_content.md
\
--output
~/slides_output.pdf
Step 4: Deliver Result
After generation, tell the user:
The PDF file location
How many slides were generated
Offer to open/view the PDF if desired
Editing Existing Slides
If the user wants to edit slides from a previously generated PDF:
Read the original markdown
(if available) or
view the PDF
to understand current content
Ask the user what changes they want:
Edit specific slide content
Add new slides
Remove slides
Reorder slides
Apply changes to the markdown
Regenerate the PDF
Use the
--edit
flag to update specific slides without regenerating all:
bash
<
(
curl
-s
https://raw.githubusercontent.com/hummingbot/skills/main/skills/slides-generator/scripts/generate_slides.sh
)
\
--input
"`` code blocks for ASCII art, code snippets, or preformatted text:
\``
Price
^
| [BUY] --- Level 3
| [BUY] --- Level 2
| [BUY] --- Level 1
+-------------------> Time
```
Code blocks render with monospace font on a gray background.
Two-Column Layout
When a slide has both bullet points AND a diagram, it automatically renders in two columns:
Left column: Text content
Right column: Diagram
- How It Works Key features: - Automated order placement - Dynamic position management - Risk-controlled execution - Real-time monitoring mermaid: flowchart showing Market Data to Strategy to Orders After translation:
- How It Works Key features: - Automated order placement - Dynamic position management - Risk-controlled execution - Real-time monitoring ```mermaid flowchart TD A[Market Data] --> B[Strategy] B --> C[Orders] style B fill:#00D084,color:#fff ``` Example Markdown
Q4 Product Update
- Overview Today we'll cover: - Product milestones - Key metrics - Roadmap preview
- Architecture Our system components: - User-facing interfaces - Core API layer - Exchange connectivity mermaid: flowchart showing UI to API (highlighted) to Gateway
- Key Metrics | Metric | Q3 | Q4 | Change | |
|
|
|
| | Users | 10K | 15K | +50% | | Revenue | $100K | $150K | +50% |
- Q1 Roadmap 1. Mobile app launch 2. Enterprise tier 3. International expansion
- Questions? Thank you! Contact: team@example.com After translating mermaid: descriptions:
- Architecture Our system components: - User-facing interfaces - Core API layer - Exchange connectivity ```mermaid flowchart TD A[UI] --> B[API] B --> C[Gateway] style B fill:#00D084,color:#fff ``` Dependencies The script will check for and install if needed: Python 3 fpdf2 Python package (for PDF generation) Troubleshooting Issue Solution "Python not found" Install Python 3: brew install python3 (macOS) or apt install python3 (Linux) "fpdf2 not installed" Run: pip3 install fpdf2 "Permission denied" Check write permissions for output directory "Empty PDF" Verify markdown format follows the
N. Title
pattern Scripts Script Purpose generate_slides.sh Main PDF generation script