Typedeck User Guide

Typedeck is a native macOS app that turns your writing into professionally themed, presentation-ready slides. Write in a minimal editor, preview your slides in real time, and present with confidence.

Create a presentation

Start a new deck from scratch, open an existing file, or pick up where you left off from the welcome screen.

Create a new document

Choose File > New (or press ⌘N) to create a blank presentation. Typedeck opens the editor with a single empty slide, ready for you to start writing.

Open an existing file

Choose File > Open (or press ⌘O) to open a file from your Mac. Typedeck works with two file formats:

  • .typedeck — The native format. A package containing your content, embedded images, and theme settings. Everything travels together in one file.
  • .md — Plain Markdown files. Typedeck opens them with the default theme and detects slide boundaries automatically.

Import Markdown

Already have a Markdown file? Choose File > Import Markdown (or press ⇧⌘I) to import its content into a new Typedeck document.

From the welcome screen

When you launch Typedeck with no documents open, the welcome screen shows your recent presentations and a button to create a new one. Click any recent file to open it, or click New Presentation to start fresh.

The editor

The Typedeck editor is organized around two interaction zones: writing (the editor area) and organizing (the thumbnail sidebar). Everything else appears on demand.

Pretty mode and raw mode

Typedeck has two display modes, toggled with ⌥⌘P or the mode button in the toolbar:

  • Pretty mode — The default experience. Headings render in large, styled serif type. Bullets are clean. Code blocks have syntax highlighting with a language badge. Tables show as editable grids. You write naturally and the editor presents your content beautifully.
  • Raw mode — For power users. Shows the full Markdown syntax in a monospaced font with inline hints. You see exactly what the document contains — every #, every -, every ```. Useful when you need precise control over formatting.

You can set your preferred startup mode in Settings > Editor > Startup Mode: Always Pretty Mode, Always Markdown Mode, or Remember Last Used.

The toolbar

The toolbar runs across the top of the editor window. From left to right:

  • Sidebar toggle — Show or hide the slide thumbnail sidebar (⌃⌘S).
  • Mode toggle — Switch between pretty mode and raw mode (⌥⌘P).
  • Paragraph style picker — A dropdown to change the current line's style: Paragraph, Heading 1, Heading 2, Heading 3, Bullet List, or Numbered List.
  • Theme picker — Open the Theme Gallery to browse and apply themes.
  • Present — Start your presentation in full screen (⇧⌘P).
  • Quick Preview — Open a floating preview window showing the current slide rendered with your theme (⌥⌘Q).
  • Grid View — See all your slides at once in a grid layout (⌥⌘G).
  • Export — Export your presentation as PDF, PPTX, HTML, or images.

Floating format toolbar

Select any text in the editor and a floating toolbar appears with formatting buttons: Bold, Italic, Strikethrough, Underline, Inline Code, and Link. Click a button to apply that format to your selection, or use the keyboard shortcuts listed under each button.

The thumbnail sidebar

The left sidebar shows a miniature preview of every slide in your deck. It's your organizing workspace:

  • Click a thumbnail to jump to that slide in the editor.
  • Drag a thumbnail up or down to reorder slides.
  • Right-click a thumbnail to duplicate, delete, or access slide-specific settings.
  • Click the "+" button between thumbnails to insert a new slide at that position.
  • Use keyboard arrows to navigate between slides when the sidebar has focus (⌘[ to focus the sidebar, ⌘] to return focus to the editor).

Slide settings (gear popover)

Click the gear icon on a selected thumbnail to open the slide settings popover. Here you can configure per-slide options:

  • Transition — Choose how this slide animates in: None, Fade, Slide, or Push.
  • Build mode — Control content reveal: Off, Bullets, or Steps. You can also cycle build modes with ⌥B.
  • Layout variation — A strip of visual thumbnails showing how your content can be arranged. Typedeck auto-selects the best variation, but you can override it. Press ⌥L to cycle through variations.

Ghost slide previews

In pretty mode, faded previews of adjacent slides appear above and below your current slide in the editor. This gives you spatial context — you can see what comes before and after without scrolling. Click a ghost slide to jump to it.

Notes drawer

Open the notes drawer with Insert > Presenter Notes (or press ⌥N). A text area expands below the editor where you can write speaker notes for the current slide. These notes appear in the presenter view during presentations but are never visible to your audience.

Grid view

Press ⌥⌘G or click the grid button in the toolbar to see all your slides laid out in a grid. This view is useful for getting an overview of your deck's flow, spotting visual inconsistencies, and quickly jumping to any slide.

Quick preview

Press ⌥⌘Q or click the preview button in the toolbar to open a floating window that shows your current slide rendered with the selected theme. The preview updates in real time as you type.

Find and replace

Press ⌘F to open Find, or ⌥⌘F to open Find and Replace. Typedeck uses the native macOS find bar, so all standard find features work: match case, contain/start with/full word, and find next (⌘G) / find previous (⇧⌘G).

Open and save files

Typedeck uses the standard macOS document model. Your changes are saved automatically as you work.

The .typedeck format

A .typedeck file is a ZIP package containing:

  • deck.md — Your Markdown content
  • images/ — Embedded images referenced in your slides
  • .typedeck-meta.json — Theme ID, aspect ratio, transition settings, and per-slide overrides

Because everything is bundled together, you can share a single .typedeck file and the recipient gets your content, images, and theme settings all in one place. It's a standard ZIP file, so you can also inspect or extract the contents with any file archiver.

Working with plain Markdown

You can open any .md file directly. Typedeck treats --- (three hyphens on a line by themselves) as slide separators and applies the default theme automatically.

To bring an existing Markdown file into a Typedeck document, use File > Import Markdown (⇧⌘I). This creates a new .typedeck document with your Markdown content ready to style.

Saving

Typedeck auto-saves your work. You can also press ⌘S to save explicitly, or use File > Save As to save a copy with a new name.

Formatting text

Format your slide content using the floating toolbar, the Format menu, keyboard shortcuts, or the paragraph style picker. You never need to write Markdown syntax by hand.

The floating format toolbar

Select any text in the editor and a floating toolbar appears with one-click formatting:

  • Bold (⌘B) — Make text bold.
  • Italic (⌘I) — Make text italic.
  • Strikethrough (⇧⌘X) — Strike through text.
  • Underline (⌘U) — Underline text.
  • Inline Code (⇧⌘C) — Format as inline code.
  • Link (⌘K) — Insert or edit a hyperlink.

Click a button to apply that format. Click it again to remove it. The toolbar disappears when you click elsewhere.

Paragraph styles

Use the paragraph style picker in the toolbar to change the current line's type:

  • Paragraph (⌘0) — Normal body text.
  • Heading 1 (⌘1) — Large slide heading.
  • Heading 2 (⌘2) — Section heading.
  • Heading 3 (⌘3) — Sub-section heading.
  • Bullet List (⇧⌘U) — Unordered list item.
  • Numbered List (⇧⌘O) — Ordered list item.

The Format menu

The Format menu in the menu bar contains all text formatting options with their keyboard shortcuts. Use this as a reference while you learn the shortcuts.

Under the hood: Markdown

All formatting is stored as standard Markdown. Bold text is wrapped in **, italic in *, headings start with #, and so on. You can see the raw syntax by switching to raw mode (⌥⌘P). But in pretty mode, you work with formatted text and never need to think about the syntax.

Adding and managing slides

Add, remove, reorder, and organize the slides in your deck — all from the sidebar or with keyboard shortcuts.

Add a new slide

There are several ways to add a new slide:

  • Keyboard shortcut — Press ⇧⌘N to insert a new slide after the current one.
  • Sidebar "+" button — Click the + button that appears between thumbnails in the sidebar to insert a slide at that position.
  • Slash command — Type / at the start of a line in the editor and choose Divider to insert a slide break.
  • Insert menu — Choose Insert > New Slide.

Reorder slides

Drag any thumbnail in the sidebar to move it to a new position. Your slide content moves with it.

Delete and duplicate slides

Right-click a thumbnail in the sidebar to access the context menu:

  • Duplicate — Creates a copy of the slide immediately after the original.
  • Delete — Removes the slide and its content.

Merge slides

Place your cursor at the very beginning of a slide's content and press Backspace. This removes the slide separator and merges the current slide's content into the previous slide.

Two-object limit

Each slide supports up to two content objects (for example, a heading plus a code block, or a paragraph plus an image). This constraint keeps your slides focused and ensures clean layouts. If you try to add a third object, Typedeck will show an indicator explaining the limit.

Under the hood

Slide breaks are stored as --- (three hyphens) on their own line in the Markdown. You can see these separators in raw mode.

Speaker notes

Write private notes for each slide that appear only in the presenter view. Your audience never sees them.

Open the notes drawer

Choose Insert > Presenter Notes (or press ⌥N) to expand the notes drawer below the editor. A text area appears where you can write notes for the current slide.

The notes drawer stays open as you navigate between slides. Each slide has its own notes that appear when that slide is selected.

Using notes during a presentation

When you present, your notes appear in the presenter view — displayed in large, easy-to-read text alongside your current slide, a timer, and a preview of the next slide. Notes are never visible to your audience and are not included in exports.

Under the hood

Notes are stored as HTML comments in the Markdown with a NOTES: prefix:

<!-- NOTES: Remember to mention the Q2 timeline
and the new hiring plan. -->

You can place these comments anywhere within a slide's content.

Images

Add images to your slides by dragging them in, using a slash command, browsing stock photos from Unsplash, or inserting from a file.

Slash command

Type / at the start of a line to open the command palette. You'll see two image options:

  • Image — Insert an image from a file on your Mac.
  • Image from Unsplash — Search and insert a professional stock photo.

Drag and drop

Drag any PNG, JPG, or GIF file from Finder directly into the editor. Typedeck embeds the image in your .typedeck file and inserts it into the current slide automatically.

Unsplash stock photos

The built-in Unsplash panel lets you search millions of professional stock photos without leaving the app. Type a search term, browse the results, and click an image to insert it. Proper attribution is handled automatically.

Crop tool

After inserting an image, you can crop it using the block handle menu. Click the grip handle on an image block and choose Crop Image to open the crop tool with preset aspect ratios.

Image layouts

Typedeck automatically chooses the best layout based on your slide content:

  • Full Image — A single image fills the slide, letterboxed to preserve aspect ratio.
  • Full Bleed — A single image cropped edge-to-edge for maximum visual impact.
  • Caption — An image with a caption line above or below it.
  • Split — An image alongside text, each taking half the slide.

Tables

Add data tables to your slides using slash commands, the Insert menu, or by pasting directly from Excel, Numbers, or Google Sheets.

Insert a table

There are several ways to add a table:

  • Slash command — Type / at the start of a line and choose Table.
  • Insert menu — Choose Insert > Table (⇧⌘T).
  • Paste from a spreadsheet — Copy cells from Excel, Numbers, Google Sheets, or any CSV source and press ⌘V. Typedeck detects tab-separated or CSV data and converts it to a table automatically.

Edit table cells

In pretty mode, tables are displayed as interactive grids. Click any cell to edit its content directly. Use Tab to move to the next cell and Shift+Tab to move to the previous cell. Press Return to confirm your edit.

In raw mode, table action bars appear on hover, showing column and row labels for quick reference.

Table style options

Click the grip handle on a table block to access style toggles:

  • Header Row — Highlight the first row as a header (on by default).
  • First Column — Emphasize the first column (off by default).
  • Banded Rows — Alternating row shading for readability (on by default).

Convert to chart

Have numeric data in a table? Click the grip handle and choose Convert to Chart to turn it into a bar, line, or pie chart. The conversion supports multi-series data, currency/percent formatting, and preserves captions. You can convert back with Show as Table on the chart's handle menu.

Code blocks

Add syntax-highlighted code to your slides using a slash command, the Insert menu, or by typing fenced code blocks.

Insert a code block

  • Slash command — Type / at the start of a line and choose Code.
  • Insert menu — Choose Insert > Code Block (⇧⌘K).

Syntax highlighting

Typedeck supports syntax highlighting for 50+ languages including Swift, Python, JavaScript, TypeScript, Go, Rust, Java, C, Ruby, and many more. In pretty mode, code blocks display with a language badge showing the detected or selected language.

Choose a language

When you insert a code block, you can specify the language for proper highlighting. In pretty mode, click the language badge on the code block to change it. In raw mode, add the language identifier after the opening backticks:

```swift
func greet(name: String) {
    print("Hello, \(name)!")
}
```

Block handle actions

Hover over a code block to see its handle. Click the grip to access Delete Code, Copy Code, Move Up, and Move Down.

Charts

Create data visualizations directly in your slides. Typedeck renders charts with your theme's colors and fonts.

Insert a chart

  • Slash command — Type / at the start of a line and choose Chart.
  • Insert menu — Choose Insert > Chart.
  • Convert from table — Click the grip handle on a table block with numeric data and choose Convert to Chart.

Chart types

Typedeck supports several chart types:

  • Bar — Vertical bars for comparing categories.
  • Line — Connected points for showing trends over time.
  • Pie — Proportional slices for showing parts of a whole.
  • Area — Filled area below a line for emphasizing volume.

Edit chart data

Chart data is defined using simple key-value pairs inside a chart code block. You can specify the chart type, title, and data values:

```chart
type: bar
title: Monthly Sales
data:
  Jan: 120
  Feb: 95
  Mar: 180
  Apr: 210
```

Block handle actions

Click the grip handle on a chart block to access Delete Chart, Show as Table (converts back to a table), Caption (add a caption), Move Up, and Move Down.

Diagrams

Create flow diagrams, process charts, and architecture visualizations using Mermaid syntax or AI-assisted generation.

Insert a diagram

  • Slash command — Type / at the start of a line and choose Diagram.
  • Insert menu — Choose Insert > Diagram.

Mermaid syntax

Diagrams use Mermaid syntax inside a diagram code block. Define nodes and connections with arrow syntax:

```diagram
Input -> Processing -> Output
Processing -> Validation
Validation -> Error [label: "invalid"]
Validation -> Processing [label: "retry"]
```

Typedeck renders the diagram with your theme's colors and fonts. Nodes appear as rounded rectangles, and connections as labeled arrows.

Zoom and pan

Complex diagrams include zoom and pan controls in both the slide preview and presentation views. Use the controls to zoom in on specific areas or pan across a large diagram.

AI-assisted diagrams

On macOS 26 or later, you can use AI Diagram from the slash command palette. Describe what you want in plain language and choose a diagram type (flowchart, sequence, class, state, entity-relationship, Gantt, or pie chart). Apple Intelligence generates the Mermaid syntax for you.

Quotes

Add blockquotes for testimonials, key insights, or memorable lines. Typedeck renders them with large, decorative typography.

Insert a quote

  • Slash command — Type / at the start of a line and choose Quote.
  • Insert menu — Choose Insert > Quote.

Add attribution

Place the attribution on a line starting with an em dash () inside the blockquote. Typedeck renders it in a smaller, secondary style beneath the quote text:

> Design is not just what it looks like and feels like.
> Design is how it works.
>
> — Steve Jobs

Block handle actions

Click the grip handle on a quote block to access Delete Quote, Copy Text, Move Up, and Move Down.

Slash command palette

Type / at the start of any empty line to open the command palette — a quick way to insert any type of content without leaving the keyboard.

How to use

Place your cursor at the start of an empty line and type /. A popup palette appears with all available content types. Start typing to filter the list, use arrow keys to navigate, and press Return to insert. Press Escape to dismiss.

Available commands

  • Text — Start typing plain text content.
  • Table — Insert a data table.
  • Code — Insert a syntax-highlighted code block.
  • Image — Insert an image from a file on your Mac.
  • Image from Unsplash — Search and insert a professional stock photo.
  • Chart — Insert a data visualization chart.
  • Quote — Insert a blockquote.
  • Diagram — Insert a flow diagram.
  • Divider — Add a slide break to start a new slide.
  • Drawing — Insert a freehand drawing.

AI commands

On supported macOS versions, additional AI-powered commands appear in the palette:

  • AI Generated Text — Write with Apple Intelligence (macOS 26+). Describe what you want and AI generates the text.
  • AI Image — Create with Image Playground (macOS 15.1+). Generate an image from a description.
  • AI Diagram — Describe a diagram to generate (macOS 26+). Choose from 7 diagram types.

The Insert menu

Every slash command is also available from the Insert menu in the menu bar. Some items have dedicated keyboard shortcuts:

  • Table⇧⌘T
  • Code Block⇧⌘K
  • New Slide⇧⌘N
  • Presenter Notes⌥N
  • Link⌘K
  • Bullet List⇧⌘U
  • Numbered List⇧⌘O

Block handles

Hover over any content block in the editor to reveal its handle — a set of controls in the left gutter for inserting, moving, and managing blocks.

The "+" button

Click the + button on a block handle to insert a new block below the current one. This opens the slash command palette so you can choose what type of content to add.

The grip menu

Click the grip icon (six dots) to open a context menu with actions specific to that block type. Every block type has Move Up and Move Down to reorder blocks within a slide.

Actions by block type

  • Text — Delete Block, Copy Text, Move Up, Move Down
  • Table — Delete Table, Copy Markdown, Move Up, Move Down, plus style toggles (Header Row, First Column, Banded Rows) and Convert to Chart
  • Chart — Delete Chart, Show as Table, Caption, Move Up, Move Down
  • Code — Delete Code, Copy Code, Move Up, Move Down
  • Image — Delete Image, Copy Image, Crop Image, Move Up, Move Down
  • Quote — Delete Quote, Copy Text, Move Up, Move Down
  • Diagram — Delete Diagram, Copy Source, Move Up, Move Down
  • Drawing — Delete Drawing, Copy Drawing, Move Up, Move Down

Drag to reorder

Grab the grip handle and drag a block up or down to reorder it within the current slide. On a two-object slide, this swaps the positions of the two objects.

Object limit indicator

When a slide has reached its two-object limit, an info indicator appears. Click it to see a popover explaining that each slide supports up to two content objects.

Auto-detected layouts

Typedeck inspects each slide's content and automatically chooses the best layout. Just write — the right layout is applied for you.

How it works

Typedeck's content analyzer runs every time you edit a slide. It looks at what your slide contains — headings, bullets, code, tables, images, charts, quotes, diagrams — and selects the layout that presents that content best. You never have to manually pick a template.

Layout types

  • Title — The first slide with only a heading and optional subtitle. Rendered as a centered opener.
  • Section — A heading-only slide that is not the first slide. Used for section breaks within a deck.
  • Standard — Heading with bullet points, paragraphs, or mixed text content.
  • Code — Contains a fenced code block with syntax highlighting.
  • Table — Contains a Markdown table with themed header and grid styling.
  • Chart — Contains a chart block for data visualizations.
  • Quote — Contains a blockquote, rendered with large decorative typography.
  • Diagram — Contains a diagram block for flow diagrams.
  • Full Image — A single image filling the slide, letterboxed to preserve aspect ratio.
  • Full Bleed — A single image cropped edge-to-edge for maximum visual impact.
  • Caption — An image with a single caption line, positioned above or below.
  • Split — An image or object alongside text, each taking half the slide.
  • Drawing — A hand-drawn sketch rendered as an SVG vector graphic.

Layout variations

Each layout type supports variations that adjust alignment, spacing, and proportions without changing your theme's colors or fonts. For example, Title slides can be centered, left-aligned, bottom-aligned, or dramatic. Standard slides can use two-column, compact, or hero variations.

To choose a variation:

  • Sidebar gear popover — Click the gear icon on a selected thumbnail to see the layout variation picker — a strip of visual thumbnails showing how your content looks in each variation. The auto-selected variation is marked with an "Auto" badge.
  • Keyboard shortcut — Press ⌥L to cycle through available variations for the current slide.

Density tiers

Variations are organized by density — how much content they're designed for. From lightest to heaviest: Statement, Key Message, Key Points, and Dense. Typedeck selects the density tier that best matches the amount of content on each slide.

Title slides

A slide with only a heading and optional subtitle is automatically rendered as a title slide — centered, bold, and designed to open your presentation.

The first such slide in your deck uses the Title layout. Subsequent heading-only slides use the Section layout, ideal for dividing your presentation into parts.

Variations

  • Centered — Default. Heading and subtitle centered on the slide.
  • Left-aligned — Heading and subtitle left-aligned, vertically centered.
  • Bottom-aligned — Heading in the bottom-left quadrant for a cinematic feel.
  • Dramatic — Heading at maximum size with subtitle as a small caption.

Code slides

When a slide contains a fenced code block, Typedeck renders it with a dedicated code layout — monospaced font, syntax highlighting, sized to fill the slide.

Specify the language after the opening backticks for proper syntax highlighting. Typedeck uses Highlightr and supports 50+ languages.

Variations

  • Default — Full-width code block.
  • Centered — Code block with horizontal margins for a more focused look.
  • Compact — Tighter line spacing for longer code listings.

Table slides

Slides containing a Markdown table use a table-optimized layout with proper column alignment, themed header styling, and clean grid lines.

Table styling

Use the block handle grip menu to toggle styling options:

  • Header Row — Highlight the first row as a header (on by default).
  • First Column — Emphasize the first column (off by default).
  • Banded Rows — Alternating row shading for readability (on by default).

Variations

  • Default — Full-width table.
  • Centered — Table with horizontal margins.
  • Vertical center — Table centered both horizontally and vertically.

Chart slides

Slides containing a chart block are rendered as themed, presentation-ready data visualizations that match your theme's colors and fonts.

Supported chart types include bar, line, pie, and area charts. Chart data is defined using simple key-value pairs inside a chart code block.

Variations

  • Default — Full-width chart.
  • Centered — Chart with horizontal margins for a more focused presentation.

Quote slides

A slide containing a blockquote is rendered with large, decorative typography — ideal for testimonials, key insights, or memorable lines.

Place the attribution on a line starting with an em dash () inside the blockquote. Typedeck renders it in a smaller, secondary style beneath the quote text.

Variations

  • Centered — Default. Large decorative quotation mark with centered text.
  • Left-aligned — Left-aligned text with an accent bar on the left edge.
  • Minimal — No ornament, centered, maximum negative space.
  • Hero — Short quotes rendered at large size for maximum impact.

Diagram slides

Slides containing a diagram block render flow diagrams, process charts, and architecture visualizations with your theme's colors and fonts.

Define nodes and connections with simple arrow syntax inside a diagram code block. Nodes are drawn as rounded rectangles, and connections are rendered as labeled arrows.

Complex diagrams include zoom and pan controls in both the slide preview and presentation views.

Choose a theme

Typedeck includes 13 built-in themes organized into three categories. Each theme defines colors, fonts, heading styles, spacing, and corner radius. Pick one and your entire presentation updates instantly.

Open the Theme Gallery

Click the theme picker button (palette icon) in the toolbar to open the Theme Gallery. The gallery shows:

  • Category rail — Filter themes by Light, Dark, Bold, or My Themes (your custom themes).
  • Live preview — See each theme applied to your actual slides. Page through your deck to check how different content looks.
  • Mini thumbnails — Quick visual comparison of all themes in the current category.
  • Aspect ratio picker — Choose 16:9 (widescreen), 4:3 (standard), or 1:1 (square) for your slides.

Click any theme to preview it, then click Apply to set it for your presentation.

Built-in themes

Light (5 themes):

  • Clean — Swiss International style, the professional default (Helvetica Neue).
  • Warm — Editorial serif warmth (Georgia, amber accents, paper tones).
  • Pastel — Soft and friendly (Avenir Next, lavender-mint palette).
  • Pitch — Startup investor deck (Futura uppercase, crisp blue).
  • Contrast — High-contrast accessible (WCAG AAA, large type).

Dark (4 themes):

  • Ink — True dark mode (OLED-friendly, desaturated accents).
  • Elegant — Gold on charcoal (Didot italic headings).
  • Neon — Cyberpunk terminal (phosphor green, Menlo monospace).
  • Mono — Developer focused (SF Mono, slate dark).

Bold (4 themes):

  • Bold — Neubrutalism-lite punch (Impact, red-orange, high contrast).
  • Gradient — Aurora color flow (indigo to violet gradient).
  • Swiss — Modernist grid design (Impact uppercase, red accent).
  • Sunset — Warm coral gradient (coral to peach).

All built-in themes use macOS system fonts and meet WCAG 2.1 AA contrast requirements.

Create custom themes

Design your own theme in the theme editor. Customize every visual aspect of your slides with a live preview that updates as you work.

Create or duplicate

Open the Theme Gallery and click New Theme to start from scratch, or right-click any existing theme and choose Duplicate to create a copy you can modify.

The theme editor

The theme editor is organized into five accordion sections:

  • Colors — Background color (solid or gradient), text colors for headings and body, accent color for links and highlights.
  • Fonts & Style — Title font family, body font family, heading weight and style, letter spacing.
  • Logo — Upload a logo image, choose placement (top-left, top-right, bottom-left, bottom-right), adjust scale, and enable watermark mode.
  • Font Sizes — Title, heading, body, and code font sizes.
  • Spacing — Margin, item spacing, section spacing, column gap, block padding, and corner radius.

A live preview pane shows your theme applied to a sample slide. Click the layout cycle button to see how different layout types look with your theme.

Undo and redo

All changes in the theme editor support undo (⌘Z) and redo (⇧⌘Z), so you can experiment freely.

Logos and watermarks

Add your company or team logo to every slide. Logos are configured in the theme editor and appear automatically on all slides using that theme.

Add a logo

Open the theme editor and expand the Logo section. Upload a PNG, JPG, or SVG image, then configure:

  • Placement — Top-left, top-right, bottom-left, or bottom-right.
  • Scale — Adjust the logo size relative to the slide.
  • Watermark mode — Enable for a subtle, semi-transparent appearance.

Logos are stored inside the theme, so anyone using the theme automatically gets the logo.

Lock a theme

Prevent accidental modifications to a custom theme by locking it with a password.

Locked themes can be applied and used normally, but cannot be edited or deleted without the password. This is useful for brand-controlled themes shared across a team — everyone presents on-brand, and no one can accidentally change the colors or fonts.

Start a presentation

Present your slides in full screen with speaker tools, transitions, and bullet builds.

Present and Rehearse

Typedeck offers two presentation modes:

  • Present (⇧⌘P or the Play button in the toolbar) — Full-screen presentation mode. The audience sees your slides; you see the presenter view.
  • Rehearse (⇧⌥⌘P) — Practice mode with the same presenter tools but in a window, so you can easily stop and make edits.

Navigate slides

  • , Space, or Return — Next slide or build step.
  • — Previous slide.
  • Escape — End the presentation.
  • Type a slide number, then press Return — Jump directly to that slide.

Screen blanking

  • B — Black screen (press again to resume).
  • W — White screen (press again to resume).

Screen blanking is useful for pausing the visual presentation during Q&A or discussion without ending the presentation.

Present from a specific slide

Select a slide in the sidebar before pressing ⇧⌘P to start the presentation from that slide instead of the beginning.

Presenter view

The presenter view is your private control center during a presentation — showing everything you need while your audience sees only the slides.

Layout

The presenter view is divided into two panels:

  • Left panel (larger)
    • Your current slide — exactly as the audience sees it.
    • Build step counter — shows progress through bullet builds (e.g., "3 of 5").
    • Speaker notes — displayed in large, easy-to-read teleprompter-style text below the slide.
  • Right panel
    • Next slide preview — see what's coming next.
    • Timer — elapsed time since the presentation started, with play/pause/reset controls.
    • Navigation controls — Previous and Next buttons.
    • End Presentation button.

Multi-monitor setup

When you have a secondary display connected, Typedeck automatically shows the full-screen presentation on the primary display and the presenter view on the secondary display. You can toggle the presenter view during a presentation by pressing P.

Screen blank indicator

When you blank the screen with B or W, the presenter view shows an indicator so you know the audience sees a blank screen. Press the same key again to resume.

Slide jump

Type any number during a presentation and press Return to jump directly to that slide. A badge in the presenter view shows the number you're typing.

Bullet builds

Reveal content one element at a time during a presentation. Each press of the Next key reveals the next element before advancing to the next slide.

Build modes

Typedeck supports three build modes:

  • Off — Default. All content is visible immediately when the slide appears.
  • Bullets — Text lines appear one by one. Objects (images, code blocks, tables) are visible immediately.
  • Steps — All elements (text lines and objects) appear one by one in document order.

Set the build mode

There are several ways to configure builds:

  • Sidebar gear popover — Click the gear icon on a selected thumbnail. The build mode picker lets you choose Off, Bullets, or Steps for that slide.
  • Keyboard shortcut — Press ⌥B to cycle through build modes for the current slide.
  • Markdown directive — Add <!-- build: bullets --> or <!-- build: steps --> as a comment in the slide content.

During a presentation

When builds are active, pressing , Space, or Return reveals the next element. The presenter view shows a build step counter (e.g., "3 of 5") so you always know your position.

Transitions

Control how slides animate when advancing during a presentation. Set a default for the entire deck or customize individual slides.

Available transitions

  • None — Instant cut with no animation.
  • Fade — Cross-fade between slides.
  • Slide — The new slide slides in from the trailing edge.
  • Push — The new slide pushes the old slide out of frame.

Set transitions

There are two ways to configure transitions:

  • Sidebar gear popover — Click the gear icon on a selected thumbnail. The transition picker lets you choose a transition for that specific slide.
  • Deck-wide default — The default transition for the entire deck is stored in your document's metadata and can be set in the sidebar settings.

Mixing transitions

Use different transitions for emphasis — for example, a hard cut for dramatic reveals and a fade for quieter moments. Per-slide transitions override the deck default.

Export to PDF

Save your presentation as a high-quality PDF document. Each slide becomes a page, preserving your theme exactly.

How to export

Choose File > Export > PDF (or press ⇧⌘E), or click the Export button in the toolbar and select PDF.

Export settings

In Settings > Export, you can configure:

  • PDF Quality — Adjust the rendering quality for smaller file sizes or sharper output.
  • Slide Numbers — Toggle whether slide numbers appear on exported pages.

When to use PDF

  • Printing slide handouts or speaker notes.
  • Sharing a read-only version that looks the same on every device.
  • Archiving a presentation for long-term storage.
  • Embedding in reports or other documents.

The PDF page size matches your deck's aspect ratio (16:9, 4:3, or 1:1).

Export to PowerPoint

Save your presentation as a .pptx file compatible with Microsoft PowerPoint, Google Slides, and Keynote.

How to export

Choose File > Export > PPTX, or click the Export button in the toolbar and select PowerPoint.

What gets exported

Typedeck generates native PowerPoint XML (OOXML format), preserving your theme's fonts, colors, text formatting, images, tables, and slide layouts. The output is a standard .pptx file that opens in any modern presentation app.

When to use PPTX

  • Sharing with colleagues who use PowerPoint or Google Slides.
  • Collaborating with teams on Windows or Microsoft 365.
  • When the recipient needs to edit the slides.

Export to HTML

Generate a self-contained web page with all slide content, images, and styling in a single HTML file.

How to export

Choose File > Export > HTML, or click the Export button in the toolbar and select HTML.

How it works

Open the exported .html file in any modern browser. Use arrow keys to navigate slides, just like in Typedeck's native presentation mode. No software installation or internet connection needed.

When to use HTML

  • Presenting from any computer with a web browser.
  • Sharing an interactive presentation via a link or email attachment.
  • Hosting slides on a website or intranet.

Export as images

Save each slide as an individual PNG or JPG image file.

How to export

Choose File > Export > Images, or click the Export button in the toolbar and select Images. Choose between PNG (lossless, best quality) and JPG (smaller file size).

Output

Each slide is exported as a separate file, numbered sequentially (e.g., Slide 1.png, Slide 2.png). The image dimensions match your deck's aspect ratio.

When to use images

  • Embedding individual slides in documents, reports, or emails.
  • Posting slides on social media.
  • Creating thumbnail galleries of your presentation.
  • Using slides as backgrounds or visual assets in other tools.

AI features

Typedeck integrates with Apple Intelligence to help you generate text, images, and diagrams — all processed on-device, privately.

Requirements

AI features require a Mac with Apple Silicon and specific macOS versions:

  • AI Generated Text — Requires macOS 26 or later.
  • AI Image — Requires macOS 15.1 (Sequoia) or later with Image Playground.
  • AI Diagram — Requires macOS 26 or later.

On supported Macs, these commands appear automatically in the slash command palette. On unsupported systems, they are hidden.

AI Generated Text

Type / and choose AI Generated Text. Describe what you want — for example, "three bullet points about our Q2 revenue growth" — and Apple Intelligence generates the text. The result is inserted as standard content that you can edit freely.

AI Image

Type / and choose AI Image. This opens Image Playground, where you describe the image you want. The generated image is inserted into your slide as a standard image block.

AI Diagram

Type / and choose AI Diagram. A prompt dialog appears where you describe the diagram and choose its type:

  • Flowchart
  • Sequence diagram
  • Class diagram
  • State diagram
  • Entity-relationship diagram
  • Gantt chart
  • Pie chart

Apple Intelligence generates the Mermaid syntax, which Typedeck renders as a themed diagram.

Privacy

All AI processing happens on-device through Apple Intelligence. Your content is never sent to external servers. No cloud account or API key is needed.

Settings

Configure Typedeck's appearance, editor behavior, and export defaults. Open Settings from the Typedeck menu or press ⌘,.

General

  • Appearance — Choose System (follows your Mac's dark/light mode), Light, or Dark for the app's interface.
  • Default Theme — The theme applied to new presentations.

Editor

  • Startup Mode — Choose whether the editor opens in Always Pretty Mode, Always Markdown Mode, or Remember Last Used (default).
  • Preset — Editor styling preset.
  • Font Size — The text size in the editor.
  • Line Width — How wide the text column is.
  • Line Numbers — Show or hide line numbers in raw mode.

Export

  • PDF Quality — Rendering quality for PDF exports.
  • Slide Numbers — Toggle whether slide numbers appear on exported slides.

Editing shortcuts

Keyboard shortcuts for file operations, navigation, and editor controls. You can also see all shortcuts in the app: choose Help > Keyboard Shortcuts.

ActionShortcut
New document⌘N
Open file⌘O
Save⌘S
Import Markdown⇧⌘I
Export as PDF⇧⌘E
Undo⌘Z
Redo⇧⌘Z
Find⌘F
Find and Replace⌥⌘F
Toggle pretty/raw mode⌥⌘P
Toggle sidebar⌃⌘S
Grid view⌥⌘G
Quick preview⌥⌘Q
Focus sidebar⌘[
Focus editor⌘]
New slide⇧⌘N
Presenter notes⌥N
Next layout variation⌥L
Cycle build mode⌥B

Formatting shortcuts

Keyboard shortcuts for text formatting and paragraph styles.

ActionShortcut
Bold⌘B
Italic⌘I
Strikethrough⇧⌘X
Underline⌘U
Inline code⇧⌘C
Link⌘K
Paragraph⌘0
Heading 1⌘1
Heading 2⌘2
Heading 3⌘3
Bullet list⇧⌘U
Numbered list⇧⌘O
Insert code block⇧⌘K
Insert table⇧⌘T

Presentation shortcuts

Keyboard shortcuts for presenting and navigating slides during a presentation.

ActionShortcut
Start presentation⇧⌘P
Rehearse⇧⌥⌘P
Next slide / build step or Space or Return
Previous slide
End presentationEscape
Jump to slideType number + Return
Black screenB
White screenW
Toggle presenter viewP

Was this help page useful? Send feedback.