Everything you need.
Pick your path.
Two guides under one roof. Use AI to write decks & edit text, or set up the CLI for full local control.
Prompting ChatGPT & Claude
Ask your favorite AI to write your slides in deckhost markdown format. The syntax is so simple it works on the first try. Copy any of the prompts below into ChatGPT, Claude, or your favorite assistant.
"Write a 10-slide pitch deck for an EV charging startup in deckhost markdown format. Include: title slide, problem, market size, our solution, traction so far, business model, team, ask. Use --- between slides and ^^^ to reveal bullet points one at a time."
"Create a 5-slide internal training on customer support tone-of-voice in deckhost markdown. Include real example phrases. Use a colored background (::: #1a1a2e), animate bullets with ^^^, and highlight the most important word in each example using **>>red**word**>>**."
"Write a 7-slide Q3 board update in deckhost markdown: revenue, product launches, hiring, lessons learned, and what's next. Use a clean gradient background, animate every list, and end with a "Thank you, questions?" slide."
"Make a 12-slide intro-to-machine-learning lecture in deckhost markdown for a non-technical audience. Use $ ... $ for math, ``` for code, and step-by-step animations (^^^). Add a definition list (Term\n: Explanation) for key concepts."
Writing Slides 101
The AI gives you a text file. Editing it is no harder than writing an email. Three things to know:
Lines that start with # become big slide headings.
Lines that start with - become bullet points.
Triple-dash --- on its own line starts a new slide.
# Welcome to My Talk
This is the title slide.
---
## The Problem
- Users are frustrated
- Tools are slow
- We can do better
Simple Animations
Make bullets appear one-by-one as you press the spacebar. Add a small symbol after the bullet:
## Key Metrics
- ^^^ Revenue grew 42% year-over-year
- ^^^ Customer base doubled
- ^^^ Net retention hit 130%
Animation cheat sheet
^^^
Fade up
vvv
Fade down
--->
Fade right
<---
Fade left
+++
Grow
~~~
Strikethrough
>>
Basic fade-in
>>red
Red highlight
>>green
Green highlight
::: #hex
Slide background
$x$
LaTeX math (inline)
Publishing
Save your file, publish it, share the link. Your audience opens it in a browser โ no downloads, no software.
Save your AI's response in any text editor. The filename ends in .md.
Drop your file into the editor at deckhost.com. Free accounts get 5 published decks.
Anyone with the link can view. Upgrade to Pro for private & password-protected decks.
Ready to make your first deck?
Free forever for 5 decks. Drop a markdown file in, get a shareable link.
$ Installation
deckhost is a Node.js CLI. Requires Node 18+. Clone the repo and run the install script — it links the binary globally and adds deckhost to your PATH.
# Clone and install
git clone https://github.com/adubinsky/deckhost.git
cd deckhost && ./scripts/install.sh
# Create a new presentation
deckhost init my-deck
$ VS Code & Cursor extension
Author decks in your editor with a live, side-by-side preview, then publish to a hosted URL without leaving the IDE. Works in both VS Code and Cursor.
- Live preview that follows your cursor and animates fragments as you type.
- Publish Live to a hosted URL — with Open on Web, Copy URL, and Unpublish one click away.
- Speaker notes and an animations key in a drawer that track the current slide.
- Pro: choose your hosted URL (platform or your custom domain) and see audience analytics. Free decks carry a watermark.
# Install the deckhost extension, open any .md deck, then:
Cmd/Ctrl+Shift+P โ deckhost: Open Live Preview
Cmd/Ctrl+Shift+P โ deckhost: Sign In # to publish
$ Local Terminal Control Engine
Three commands run the entire local development cycle.
deckhost serve
Starts the local dev server with hot-reloads on save.
Watches your markdown file, re-renders on save, opens a browser preview. Use during authoring.
deckhost build
Compiles presentations into isolated, static HTML outputs for easy custom self-hosting.
Outputs a self-contained dist/ directory you can drop on any static host (Netlify, S3, GitHub Pages, your own server).
deckhost publish
Deploys local markdown assets directly to deckhost.com cloud spaces.
Authenticates with your account, uploads the deck, returns a permanent URL. Re-run anytime to update the same link.
$ Wire it into Claude (MCP)
deckhost ships with an MCP server. One command points Claude Desktop or Claude Code at your local deckhost install — from then on, Claude can create, edit, and publish decks inside the conversation.
# Auto-detect Claude Desktop / Claude Code and configure
deckhost init --mcp
# Then in Claude, ask:
"Create a 12-slide deck about renewable energy trends"
$ Syntax reference
The full deckhost markdown grammar at a glance.
---
Horizontal slide break
--
Vertical (nested) slide break
::: #hex
Solid color
::: linear-gradient(โฆ)
Any CSS gradient
::: https://โฆ
Image URL
::: opacity:0.3
Image opacity
- ^^^ Item^^^
Fade up
vvv
Fade down
--->
Fade right
<---
Fade left
+++
Grow
~~~
Strikethrough
>>
Basic fade-in
>>red
Highlight (red)
>>green
Highlight (green)
>>blue
Highlight (blue)
^^^โฆ^^^
Inline fade up
+++โฆ+++
Inline grow
~~~โฆ~~~
Inline strike
**>>red**โฆ**>>**
Inline red highlight
$x$
Inline LaTeX
$$x$$
Block LaTeX
text[^1]
Footnote ref
[^1]: ref
Footnote def
Term\n: Def
Definition list
*[ABBR]: def
Slide abbreviation
Avoid using ... for ellipses — the preprocessor reads it as a text-shrink animation. Use the single-character โฆ (U+2026) instead.
Build local. Ship global.
Push your first deck to a permanent URL. Free forever for 5 decks; Pro plans get private decks, analytics, and a custom domain.