md-to-gamma

name	md-to-gamma
description	Pre-process Markdown into a Gamma-import-ready version.
lastReviewed	2026-04-30T00:00:00.000Z

md-to-gamma

Pre-process Markdown into a Gamma-import-ready version.

When to Use

• Authoring presentations in Markdown then importing to Gamma
• Converting blog posts or docs into slide decks
• Round-tripping content between writing tools and Gamma

What's Here

md-to-gamma.cjs — Node script (no external deps).

External Dependencies

• node (≥ 16) — that's it

Usage

node md-to-gamma.cjs input.md
# Emits input-gamma.md alongside the source

What It Does

• Adjusts heading levels for Gamma's slide-per-heading model
• Strips frontmatter that Gamma doesn't read
• Converts Mermaid blocks to references Gamma can render
• Inserts slide-break markers where Gamma expects them

Workflow

1. Author your deck as standard Markdown
2. Run md-to-gamma.cjs your-deck.md
3. In Gamma, Import → Markdown → upload your-deck-gamma.md
4. Edit visually in Gamma if you want, or re-run the converter on edits

Notes

• Works offline — no API key, no network
• Companion to the gamma-presentation skill if you want full presentation tooling