---
title: Markdown-to-Presentation Workflow
type: article
created: '2026-04-05'
updated: '2026-04-05'
source_docs:
- raw/2026-01-22-weekly-call-w-ben-116441379.md
tags:
- markdown
- gamma
- presentations
- ai-workflow
- claude
- content-marketing
layer: 2
client_source: null
industry_context: null
transferable: true
---

# Markdown-to-Presentation Workflow

A repeatable process for generating AI-authored strategy documents in Markdown, editing them in Google Docs, and converting them into polished slide decks via Gamma. This workflow emerged from client strategy planning work and is designed to keep content portable and platform-agnostic throughout the production pipeline.

## Why Markdown

Markdown is the preferred output format for AI-generated documents because it is:

- **Portable** — can be pasted into Google Docs, Notion, Obsidian, or any other tool without reformatting
- **Structured** — heading levels (`#`, `##`, `###`) map directly to document hierarchy and slide structure
- **Gamma-compatible** — Gamma reads Markdown natively and uses it to auto-generate slide layouts

Avoid requesting output as PDF (hard to edit), Word (platform-locked), or CSV (wrong shape for narrative content). Always ask Claude to write in Markdown.

## The Three-Stage Pipeline

### Stage 1 — Generate in Claude

Ask Claude to produce strategy documents in Markdown. For client strategy work, the standard output set is:

1. **Overview** — current state snapshot, key findings, market context
2. **Annual Plan** — quarterly breakdown of priorities and tactics
3. **Presentation** — a narrative version of the plan, written for a client audience
4. **Q1 OKRs** — measurable objectives and key results for the first quarter

**Prompting tips:**
- Tell Claude what you need *before* feeding it data: *"I'm going to give you a bunch of information. Don't write anything yet — just absorb it. I'll tell you when to start."* This prevents premature output mid-upload.
- Specify all four deliverables upfront so Claude plans the output holistically.
- Request Markdown explicitly: *"Write everything in Markdown format."*

See [[knowledge/ai-workflow/claude-client-strategy-process]] for the full data-ingestion and prompting workflow.

### Stage 2 — Edit in Google Docs

Once Claude produces the Markdown output:

1. Copy the raw Markdown text
2. Open a Google Doc
3. Go to **Edit → Paste from Markdown**
4. Google Docs renders the Markdown into formatted headings, bullets, and body text

This gives you a clean, editable document without any manual reformatting. Make tone and content edits here before moving to the deck stage.

**Common edit at this stage:** Ask Claude to rewrite any sections that sound critical of past performance. Prompt: *"Rewrite this so it sounds proactive and forward-looking — don't make it look like things are currently broken."* See [[knowledge/ai-workflow/tone-refinement-for-client-presentations]] for more on this.

### Stage 3 — Build the Deck in Gamma

1. Go to [Gamma](https://gamma.app) and select **Create New → Paste in text**
2. Paste the Markdown from the Presentation document (not the full plan — use the presentation-specific output)
3. Gamma auto-generates a prompt and slide structure from the Markdown
4. Select a theme and let it render

**To control deck length and scope:** Rather than pasting raw Markdown and hoping for the right output, ask Claude to write a Gamma-specific prompt first:

> *"Write me a Gamma prompt that will generate a 10-slide-or-less deck from this plan. Tell Gamma what to include and what to leave out."*

Paste that prompt into Gamma instead of the raw document. This gives you tighter control over slide count and content emphasis.

**Post-generation cleanup:**
- Delete auto-inserted stock images that don't fit
- Trim any slides that contain information the client shouldn't see (e.g., gap analyses that imply prior neglect)
- Adjust theme colors to match client branding if needed

## Iterating the Deck

If the first Gamma output is too long or too detailed:

1. Go back to Claude
2. Ask for a condensed version: *"Give me a shorter presentation — 10 slides or less"*
3. Re-import the condensed Markdown into Gamma

It's faster to regenerate in Claude and re-import than to manually cut slides in Gamma.

## Recommended Tools

| Tool | Role |
|---|---|
| Claude | Document generation, tone refinement, Gamma prompt writing |
| Google Docs | Markdown rendering, editing, sharing drafts |
| Gamma | Slide deck generation from Markdown |
| Awesome Screenshot (browser extension) | Full-page screenshots for feeding visual data to Claude |

## Related Processes

- [[knowledge/ai-workflow/claude-client-strategy-process]] — Full workflow for feeding client data to Claude and generating the four strategy documents
- [[knowledge/ai-workflow/tone-refinement-for-client-presentations]] — How to use Claude to reframe critical findings as proactive recommendations
- [[knowledge/ai-workflow/client-pushback-roleplay]] — Using Claude to simulate client questions and pressure-test a plan before presenting
- [[clients/exterior-renovations/_index]] — First client this workflow was applied to
- [[clients/overhead-door/_index]] — Second client; same process applied