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.
The editor
Two display modes, a live toolbar, slide thumbnails, and a preview pane.
Slash commands
Type / to insert tables, code, images, charts, diagrams, and more.
Choose a theme
Pick from 13 built-in themes or design your own with custom colors and fonts.
Start presenting
Speaker notes, timer, next-slide preview, bullet builds, and transitions.
Export your slides
Save as PDF, PPTX, HTML, PNG, or JPG for sharing and printing.
Keyboard shortcuts
Every action has a shortcut. Master the keyboard to work faster.
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.
| Action | Shortcut |
| 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.
| Action | Shortcut |
| 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.
| Action | Shortcut |
| Start presentation | ⇧⌘P |
| Rehearse | ⇧⌥⌘P |
| Next slide / build step | → or Space or Return |
| Previous slide | ← |
| End presentation | Escape |
| Jump to slide | Type number + Return |
| Black screen | B |
| White screen | W |
| Toggle presenter view | P |