What is Marp diapo

Marp diapo is a specialized assistant that turns your intent into production-ready Marp Markdown (a Markdown format that renders slide decks). Its design goal is to remove friction in slide creation: you describe what you need, and it delivers clean, theme-aware, paginated slides with presenter notes embedded in HTML comments. Core design choices: • Conversation first: before generating any deck, it asks exactly five setup questions (number of slides, whether you want presenter comments, the topic, the slide language, and how many slides to output per iteration). It asks these one by one to avoid ambiguity. • Marp-native output: it emits valid front matter and slide sections that work out of the box in Marp/Marp CLI, VS Code Marp extension, and GitHub Pages. • Presenter support: every slide can include concise presenter notes inside HTML comments (e.g., <!-- ... -->) so notes are invisible to the audience but visible to the presenter. • Pagination by default: it uses Marp's paginate option instead of numbering titles by hand. Minimal example (what a first slide can look like): ``` --- marp: true paginate: true theme: default --- # Kubernetes 101 - Why orchestrationMarp diapo introduction matters - Pods vs Deployments - Basic workflows <!-- Presenter notes: Define 'Pod' simply; emphasize desired-state model; mention kubectl apply. --> ``` Scenario illustration: • You say: 'Topic: Accessible Web Design, English, 12 slides, include presenter comments, 4 slides per batch.' • Marp diapo confirms each missing detail, then outputs the first 4 slides (with notes), using `paginate: true`. You review, request tweaks ('Make the tone more hands-on, add a WCAG checklist slide'), and it regenerates just those slides before continuing with the next batch.

Key functions and how they play out

  • Structured intake & deck planning

    Example

    Pseudo-transcript of the one-by-one setup: 1) 'How many slides do you expect?' → '10' 2) 'Do you want presenter comments?' → 'Yes' 3) 'What’s the topic?' → 'Introduction to Prompt Engineering' 4) 'Which language for the slides?' → 'English' 5) 'How many slides per iteration?' → '5' Resulting spec (internally): `{slides: 10, notes: true, topic: 'Prompt Engineering', lang: 'en', batch: 5}` It then plans an outline (opening, core concepts, techniques, pitfalls, exercises, recap) and maps this to slide count.

    Scenario

    A people manager needs a 10-slide onboarding deck in French with speaker notes. Marp diapo asks the five inputs, proposes an outline tailored to onboarding (company mission → tools → teamwork norms → first-week checklist), and locks the plan before generating the first batch so the manager can redirect early if needed.

  • Marp Markdown generation with pagination, themes, assets, and presenter notes

    Example

    Sample front matter + slides: ``` --- marp: true theme: gaia paginate: true header: 'API Security 101' footer: 'Acme • 2025' --- # Why API Security Now? - Breach trends and costs - Attacker mindset - Shift-left practices <!-- Presenter notes: Open with a recent incident; quantify average breach cost; set up the 'shift-left' frame. --> --- ![bg fit](images/token-lifecycle.png) # OAuth 2.0 in One Picture - Roles: Resource Owner, Client, Authorization Server - Tokens: Access vs Refresh <!-- Presenter notes: Use the background image to narrate a single user flow; highlight token expiration. --> --- ## Secure Defaults Checklist - Enforce TLS everywhere - Rotate secrets - Scope tokens narrowly ```

    Scenario

    A developer advocate needs demo-ready slides for a conference talk. Marp diapo emits clean Markdown that the advocate can serve locally via Marp CLI, includes background images with `![bg fit](...)`, and bakes in short, actionable notes for live delivery. Pagination ensures consistent slide numbers on stage timers.

  • Iterative refinement, batching, and localization

    Example

    Focused regeneration and localization: • Request: 'Regenerate slides 2–4 in Spanish, keep the tone formal, add a short code example.' • Output (excerpt): ``` --- marp: true paginate: true theme: default --- ## Patrón de reintentos (exponencial) ```js async function fetchWithRetry(fn, max=5) { for (let i=0; i<max; i++) { try { return await fn(); } catch (e) { await wait(2 ** i * 100); } } } ``` <!-- Notas del presentador: Aclare retroceso exponencial; mencione jitter para evitar sincronización. --> ```

    Scenario

    A global team reuses one deck for EMEA and LATAM. Marp diapo first delivers the English version in two batches, then regenerates specific slides in Spanish while preserving structure and pagination. The team comments on only the changed slides, keeping review time minimal.

Who benefits most

  • Educators, trainers, and instructional designers

    They frequently need structured, repeatable decks with clear learning outcomes and speaker notes. Marp diapo helps by rapidly producing pedagogically organized slides (intro → objectives → content → practice → recap) with concise presenter comments for delivery. Iterative batches make it easy to validate the learning path before committing to the full deck, and localization supports multi-cohort, multi-language courses.

  • Product teams, founders, and sales engineers

    They ship pitches, release overviews, and solution demos under time pressure. Marp diapo converts a bare outline into a themed, paginated deck that can include background visuals and short code/config snippets. Presenter notes double as talk tracks for demos. The iterative flow allows quick tailoring for different audiences (e.g., investor vs. customer) without rebuilding from scratch.

How to use Marp diapo

  • Visit aichatonline.org for a free trial without login, also no need for ChatGPT Plus.

    Open the site and launch Marp diapo instantly in your browser—no account, no paid plan.

  • Define your brief

    State topic, language, total slides, batch size per iteration, and whether you want presenter notes. Mention audience, tone, theme (e.g., gaia, uncover), and any brand colors or logo URLs to guide styling.

  • Request the deck

    Ask for Marp Markdown with front-matter (e.g., "---\npaginate: true\n---"). Marp diapo will structure slides with headings, concise bullets, and HTML comments for speaker notes. Typical uses: lectures, pitch decks, onboarding, research talks, workshops.

  • Refine in iterations

    Generate slides in batches (e.g., 5 at a time), then ask for edits: tighten bullets, add examples, include code blocks, add references, or adjust layout. Tip: keep ~5 lines per slide, use strong slide titles, and maintain consistent terminologyMarp diapo usage guide.

  • Export & present

    Copy the Markdown into Marp for VS Code or marp-cli to export PDF/HTML/PPTX. Verify pagination, links, and images. Use the HTML comment notes while rehearsing; finalize branding with theme or inline CSS before sharing.

  • Pitch Decks
  • Lectures
  • Workshops
  • Onboarding
  • Research Talks

Marp diapo: common questions answered

  • What exactly is Marp diapo?

    Marp diapo is an AI that writes clean Marp Markdown for slide decks. It asks for topic, language, slide count, iteration size, and whether to include presenter notes, then outputs a themed, paginated deck with clear structure and optional notes embedded per slide.

  • How are presenter notes added and viewed?

    Notes are embedded inside HTML comments on each slide, e.g., "<!-- Presenter: emphasize result X; ask question Y -->". They’re hidden in exported slides but visible in the Markdown or presenter view tools that read HTML comments.

  • Can I control pagination and layout?

    Yes. Marp diapo includes front-matter like "paginate: true" for page numbers. You can request themes (gaia, uncover), set title slides ("class: lead"), add footers, and specify layout cues (two-column via concise content blocks or background images).

  • Can you include code, math, or diagrams?

    Yes for code blocks with syntax highlighting (e.g., ```js ... ```). For math, export with tools that support KaTeX. Diagrams can be included as images or ASCII; Mermaid requires pre-rendering or a compatible pipeline.

  • How do I export to PDF, HTML, or PPTX?

    Paste the Markdown into Marp for VS Code to preview and export, or use marp-cli: "npx @marp-team/marp deck.md -o deck.pdf" (PDF), "-o deck.html" (HTML), or "-o deck.pptx" (PPTX). Check fonts, images, and links before sharing.

cover