Create a presentation

Start a new deck from scratch, open an existing file, or jump back into a recent presentation from the startup window.

Create a new document

Choose File > New (⌘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 (⌘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 using --- separators.

Import Markdown

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

From the startup window

When you launch Typedeck with no documents open, the startup window gives you three fast paths: click New Presentation to start blank, click Open… to browse for a file, or choose any recent presentation from the list on the right. The left side of the window also includes Explore Sample Deck and Quick Tour for getting oriented.

The editor

Typedeck's editor shows one slide at a time. Write your title, add content cards, and see your slide take shape in the live preview.

Single-slide view

The editor focuses on one slide at a time. At the top you write the slide's title and optional subtitle. Below that, you add content cards — typed blocks like text, images, tables, code, charts, and more. A live preview on the right shows exactly how the slide will look.

Content cards

Each slide supports up to two content cards. Click + Add content to slide or type / at the start of an empty line to open the content type picker. Choose what you want to add and Typedeck gives you a purpose-built editor for that content type. Cards can be reordered by dragging.

The toolbar

The toolbar runs across the top of the editor window:

• Sidebar toggle — Show or hide the slide thumbnail sidebar (⌃⌘S).
• Theme picker — Open the Theme Gallery to browse and apply themes.
• Present — Start your presentation in full screen (⇧⌘P).
• Layout Editor — Fine-tune layout, text size, reveal, transition, and footer (⌥⌘Q).
• Export — Export your presentation as PDF, PPTX, HTML, or images.

The thumbnail sidebar

The left sidebar shows a miniature preview of every slide in your deck:

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

Notes drawer

Open the notes drawer with View > Notes (⌃⌘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 but are never visible to your audience.

Grid view

Press ⌥⌘G or click the grid button in the toolbar to see all your slides at once. Useful for getting an overview of your deck's flow and jumping to any slide.

Find and replace

Press ⌘F to open Find, or ⌥⌘F to open Find and Replace. Typedeck uses the native macOS find bar with all standard features.

Open and save files

Typedeck uses the standard macOS document model. After you create a document file, 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, slide size, transition settings, and slide customizations.

Share a single .typedeck file and the recipient gets your content, images, and theme settings all in one place.

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. Use File > Import Markdown (⇧⌘I) to bring a Markdown file into a new .typedeck document.

Saving

Typedeck asks you to create a file when starting a new untitled document. After that, your work auto-saves continuously. Press ⌘S to save explicitly, or use File > Save As to save a copy.

Import from Notion

"Turn any Notion page into a Typedeck presentation. Typedeck reads your content, converts it to slides, and downloads embedded images — all in a few clicks."

Connect your Notion workspace

Choose File > Import from Notion to begin. The first time, Typedeck asks you to connect your Notion account. Click Connect to Notion and authorize read-only access in the browser window that appears. Typedeck never modifies or deletes anything in your Notion workspace.

Your connection is stored locally in your Mac's Keychain. You can view your connection status or disconnect at any time in Settings > Accounts.

During authorization, Notion asks which pages Typedeck can access. You can share individual pages or your entire workspace. If you choose individual pages, only those pages will appear in the import picker.

Share additional pages with Typedeck

1. Open the page in Notion.
2. Click the ··· menu in the top-right corner of the page.
3. Select Connections (or Connect to).
4. Find Typedeck in the list and add it.

The page will appear in Typedeck's import picker immediately.

To avoid this step for future pages, you can disconnect and reconnect with access to your full workspace. Go to Settings > Accounts and click Disconnect, then use File > Import from Notion again and choose all pages during the Notion authorization screen.

Choose a page to import

After connecting, Typedeck shows a page picker with your recent Notion pages. Use the search field to find a specific page by name. Select the page you want and click Import (or double-click the page).

Typedeck fetches the page content, converts it to Markdown slides, and downloads any embedded images. The result opens as a new Typedeck document ready for styling.

What converts and what doesn't

Typedeck converts the most common Notion block types:

• Headings — H1 and H2 headings become slide boundaries. Each heading starts a new slide.
• Text paragraphs — Converted with full formatting: bold, italic, strikethrough, inline code, and links.
• Bulleted and numbered lists — Converted to Markdown lists with up to two levels of nesting.
• To-do lists — Converted to checkbox lists (- [x] / - [ ]).
• Tables — Converted to Markdown pipe tables with header row detection.
• Code blocks — Preserved with language annotation for syntax highlighting.
• Quotes — Converted to blockquotes.
• Images — Downloaded and embedded in the .typedeck file.
• Callouts — Converted to blockquotes with the emoji icon preserved.
• Bookmarks — Converted to Markdown links.
• Dividers — Treated as slide breaks.
• Toggles — The toggle title is bolded and child content is shown below it.

A few Notion-specific block types are skipped during import: databases, embeds, videos, audio files, and table-of-contents blocks. These have no direct equivalent in a presentation.

Writing in Notion for best results

• Use headings to define slides. Every H1 or H2 heading starts a new slide. Think of each heading as a slide title. An H3 stays on the same slide as a sub-heading.
• Use dividers for manual slide breaks. Add a Notion divider (---) wherever you want a slide to end, regardless of headings.
• Keep lists focused. Six bullets per slide is comfortable; more than ten and the text will get small. Split long lists across multiple sections.
• One table per section. Tables work best on their own slide. Put a heading above the table and keep it to six rows or fewer for readability.
• Put images on their own line. An image on its own (not mixed with text) gets a full-image layout. An image with a short caption gets a caption layout.
• Keep code blocks short. Fifteen lines of code fit comfortably. Longer blocks will still import, but consider splitting them.

After importing

• Apply a different theme from the toolbar.
• Adjust individual slide layouts using the Layout Editor (⌥⌘Q).
• Add speaker notes, images, or additional slides.
• Export to PDF, PowerPoint, HTML, or images.

Import from Obsidian

"Turn any Obsidian note into a Typedeck presentation. Typedeck reads your Markdown, converts Obsidian-specific syntax, resolves local images from your vault, and splits the content into slides."

Choose a note to import

Choose File > Import > Obsidian Note to begin. Typedeck opens a file picker filtered to Markdown (.md) files. Navigate to your Obsidian vault folder, select one or more notes, and click Open.

You can select multiple notes at once — Typedeck imports them in order and places a slide break between each file.

What happens during import

• Converts Obsidian-specific syntax (wiki-links, callouts, highlights, embeds) to standard Markdown.
• Finds and embeds images referenced in your notes by searching your vault's attachment folders.
• Inserts slide breaks at headings and when content gets long enough to fill a slide.
• Opens the result as a new Typedeck document with the default theme applied.

A summary appears when the import finishes, showing how many slides were created, how many images were embedded, and any content that was skipped or simplified.

What converts and what doesn't

• Headings — H1 and H2 headings become slide boundaries.
• Text paragraphs — Converted with full formatting: bold, italic, strikethrough, inline code, and links.
• Bulleted and numbered lists — Converted to Markdown lists with nesting preserved.
• Wiki-links — [[Page Name]] becomes plain text. Aliased links like [[Page|display text]] use the display text.
• Image embeds — ![[photo.png]] images are found in your vault and embedded in the .typedeck file.
• Note embeds — ![[Other Note]] inlines that note's content (one level deep to prevent circular references).
• Callouts — > [!note] Title becomes a blockquote with a bold label.
• Highlights — ==highlighted text== becomes bold text.
• Code blocks — Preserved with language annotation for syntax highlighting.
• Mermaid diagrams — Kept as-is. Typedeck renders Mermaid diagrams natively.
• Tables — Converted to Markdown pipe tables.
• Frontmatter — YAML frontmatter is stripped, but the title field is used as the first slide heading if present.
• Existing slide breaks — --- delimiters are preserved as slide breaks.

A few Obsidian-specific features are skipped: Dataview queries, comments (%% hidden %%), tags (#my-tag), and block IDs (^block-id).

How Typedeck finds your images

Typedeck searches for images in the following locations:

• Your vault's configured attachment folder (read from .obsidian/app.json).
• The same folder as the note.
• The vault root directory.

If Typedeck can't find an image, it skips it and includes a note in the import summary.

Writing in Obsidian for best results

• Use headings to define slides. Every H1 or H2 heading starts a new slide.
• Use horizontal rules for manual slide breaks. Add --- wherever you want a slide to end.
• Keep lists focused. Six bullets per slide is comfortable.
• One table per section. Tables work best on their own slide.
• Put images on their own line. Gets a full-image layout.
• Keep code blocks short. Fifteen lines fit comfortably.

After importing

• Apply a different theme from the toolbar.
• Adjust individual slide layouts using the Layout Editor (⌥⌘Q).
• Add speaker notes, images, or additional slides.
• Export to PDF, PowerPoint, HTML, or images.

Content cards

Each slide holds a title, an optional subtitle, and up to two content cards. Pick a content type and Typedeck gives you a purpose-built editor for it.

Adding content

There are three ways to add a content card to a slide:

• + button — Click + Add content to slide below your existing content. This opens the content type picker.
• / keystroke — Type / at the start of an empty line to open the picker without leaving the keyboard.
• Insert menu — Choose a content type from the Insert menu in the menu bar.

All three open the same content type picker.

Content types

• Text — Body text with headings, bullets, and formatting.
• Table — An editable data grid.
• Code — A syntax-highlighted code block.
• Image — From a file on your Mac.
• Image from Unsplash — Search and insert a free stock photo.
• Chart — Bar, line, pie, or area chart.
• Quote — A blockquote with optional attribution.
• Diagram — A Mermaid flow diagram.
• Draw Shapes — Vector shapes, arrows, and text labels.
• Image or Sketch from iPhone or iPad — Capture from a nearby device.
• PDF — Insert a page from a PDF document.
• Divider — Insert a slide break to start a new slide.

Card header

Each card has a header showing its content type badge. Text cards also show persistent format buttons (Bold, Italic, Bullet List, Numbered List, H1, H2) for quick formatting. Click the × button to delete a card.

Reorder and captions

Drag a card to reorder it within the slide. Non-text cards have an optional caption field below the content.

Two-card limit

Each slide supports up to two content cards. This keeps your slides focused and ensures clean layouts. If a slide already has two cards, the content type picker is replaced with a message explaining the limit.

Formatting text

Format text with the buttons in the card header, the floating toolbar, the Format menu, or keyboard shortcuts.

Card header format buttons

Text cards show persistent format buttons right in the card header: Bold, Italic, Bullet List, Numbered List, H1, and H2. These are always visible — no need to select text first.

Floating format toolbar

Select any text in the editor and a floating toolbar appears with additional formatting:

• Bold (⌘B)
• Italic (⌘I)
• Strikethrough (⇧⌘X)
• Underline (⌘U)
• Inline Code (⌃⌘C)
• Link (⌘K)

Paragraph styles

Change the current line's type with keyboard shortcuts:

• 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.

Under the hood

All formatting is stored as standard Markdown. You never need to write Markdown by hand — Typedeck takes care of it.

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

• Keyboard shortcut — Press ⇧⌘N to insert a new slide after the current one.
• Sidebar "+" button — Click the + button between thumbnails to insert at that position.
• Content type picker — 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.

Delete and duplicate

Right-click a thumbnail to access the context menu with Duplicate and Delete options.

Merge slides

Place your cursor at the very beginning of a slide's content and press Backspace to merge it into the previous slide.

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 View > Notes (⌃⌘N) to expand the notes drawer below the editor. Each slide has its own notes.

During a presentation

Your notes appear in the presenter view in large, easy-to-read text alongside your current slide, a timer, and the next slide preview.

Text Content

"The default content card. Write paragraphs, headings, and lists with persistent format buttons in the card header."

Insert

Type / and choose Text, or click + Add content to slide and select Text. You can also just start typing in an empty card.

Formatting

Text cards show Bold, Italic, Bullet List, Numbered List, H1, and H2 buttons in the card header. Select text to see additional formatting options in the floating toolbar.

Block menu

Click the ⋯ button to access Change Type, Recognize Content, Move to Slide, Delete Block, Copy Text, Move Up, and Move Down.

Images

"Add images to your slides from a file, from Unsplash, from a nearby iPhone or iPad, or by dragging them in."

Insert an image

• Content type picker — Choose Image to browse files on your Mac, or Image from Unsplash to search free stock photos.
• Drag and drop — Drag any PNG, JPG, or GIF from Finder into the editor.
• iPhone or iPad — Choose Image or Sketch from iPhone or iPad to capture a photo, scan, or sketch from a nearby device.

Unsplash stock photos

The built-in Unsplash panel lets you search millions of professional photos. Click an image to insert it. Attribution is handled automatically.

Crop tool

Click ⋯ on an image card and choose Crop Image to open the crop tool with preset proportions.

Image layouts

• Full Image — Fills the slide, letterboxed to preserve proportions.
• Full Bleed — Cropped edge-to-edge for maximum impact.
• Caption — Image with a caption above or below.
• Split — Image alongside text, each taking half the slide.

Tables

Add data tables using the content type picker, the Insert menu, or by pasting from Excel, Numbers, or Google Sheets.

Insert a table

• Content type picker — Choose Table.
• Insert menu — Choose Insert > Table (⇧⌘T).
• Paste from a spreadsheet — Copy cells and press ⌘V. Typedeck detects tab-separated or CSV data automatically.

Edit cells

Click any cell to edit it. Use Tab to move to the next cell, Shift+Tab for the previous cell, and Return to confirm.

Style options

Click ⋯ on a table card to toggle:

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

Convert to chart

Have numeric data? Click ⋯ and choose Convert to Chart to turn it into a visualization. Convert back with Show as Table.

Code blocks

Add syntax-highlighted code with language-aware colors for 50+ languages.

Insert

• Content type picker — Choose Code.
• Insert menu — Choose Insert > Code Block (⇧⌘K).

Code colors

Typedeck supports 50+ languages including Swift, Python, JavaScript, TypeScript, Go, Rust, Java, C, Ruby, and many more. Code blocks display with a language badge.

Choose a language

Click the language badge to change the language. The code colors update instantly.

Charts

Create bar, line, pie, and area charts that render with your theme's colors and fonts.

Insert

• Content type picker — Choose Chart.
• Insert menu — Choose Insert > Chart.
• Convert from table — Click ⋯ on a table with numeric data and choose Convert to Chart.

Chart types

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

Edit data

Charts use a simple Name/Amount format. The default chart starts with sample data that you can edit directly. Multi-series charts use additional columns.

Quotes

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

Insert

• Content type picker — Choose Quote.
• Insert menu — Choose Insert > Quote.

Attribution

Add an attribution line starting with an em dash (—). Typedeck renders it in a smaller style beneath the quote.

Diagrams

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

Insert

• Content type picker — Choose Diagram.
• Insert menu — Choose Insert > Diagram.

Mermaid syntax

Diagrams use Mermaid syntax. Define nodes and connections with arrow syntax. Typedeck renders them with your theme's colors and fonts.

Zoom and pan

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

AI-assisted

On macOS 26+, choose AI Diagram from the content type picker. Describe what you want and choose a diagram type.

Shapes

Draw rectangles, ellipses, lines, arrows, and text labels on a full-slide canvas.

Insert

Choose Draw Shapes from the content type picker or Insert > Drawing.

Drawing tools

• Rectangle and Ellipse — Draw filled or stroked shapes.
• Line and Arrow — Draw straight connectors with optional arrowheads.
• Text label — Add text annotations at any position.

Styling

Customize fill and stroke colors, line widths, and text sizes. Hold Shift while drawing lines to snap to horizontal or vertical.

Full-slide exclusivity

Shape slides are exclusive: a shape canvas always gets the full slide.

PDF

Insert a page or cropped region from a PDF document directly into your slide.

Insert

Choose PDF from the content type picker or Insert > PDF. Browse for a PDF file on your Mac.

Page picker

For multi-page PDFs, a page grid lets you choose which page to insert. Single-page PDFs skip straight to the region selector.

Region selector

After choosing a page, crop to the region you want. The default crop is a 16:9 rectangle centered at full width. Drag the handles to adjust.

Auto-detected layouts

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

How it works

Every time you edit a slide, Typedeck reads what it contains — headings, text, code, tables, images, charts, quotes, diagrams — and picks the layout that presents it best.

Layout types

• Title — A heading-only first slide, centered as an opener.
• Section — A heading-only slide that isn't the first, for section breaks.
• Standard — Heading with bullets, paragraphs, or mixed text.
• Code — A fenced code block with code colors.
• Table — A data table with themed styling.
• Chart — A data visualization chart.
• Quote — A blockquote with decorative typography.
• Diagram — A flow diagram.
• Full Image — A single image filling the slide.
• Full Bleed — A single image cropped edge-to-edge.
• Caption — An image with a caption line.
• Split — An image alongside text.
• Drawing — A hand-drawn sketch as SVG.

The Layout Editor

A spacious modal for fine-tuning your slide with a full-size preview alongside layout, text size, reveal, transition, and footer controls.

Open the Layout Editor

Double-click a thumbnail, click the layout button on a selected thumbnail, or press ⌥⌘Q.

Layout section

Browse all available layouts as visual thumbnails. The suggested layout is marked with a Suggested badge. Your custom choice is saved per-slide. Press ⌃⌘L to cycle through layouts with a keyboard shortcut.

Text size

Adjust body text size for the current slide with the text size control. Five levels from XS to XL (default is M). This affects text, quotes, and code — not headings.

Reveal

Control how content appears during a presentation:

• Off — All content visible immediately.
• Bullets — Text lines appear one by one.
• Steps — All elements appear one by one.

Transition

Choose how this slide animates in: None, Fade, Slide, or Push.

Footer

Toggle Slide Numbers and add Footer Text (e.g., your company name). These appear at the bottom of every slide.

Slide numbers and footer

Add slide numbers and custom footer text that appear at the bottom of every slide in previews, presentations, and exports.

Enable slide numbers

Toggle slide numbers in the Layout Editor's Footer section, or choose Insert > Slide Numbers from the menu bar.

Add footer text

Type your footer text (e.g., a company name or date) in the Layout Editor's Footer section, or choose Insert > Footer to open the footer editor.

Where they appear

Slide numbers and footer text appear in thumbnails, the live preview, presentations, and all export formats.

Title slides

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

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

Layouts

• Centered — Default. Heading and subtitle centered.
• Left-aligned — Left-aligned, vertically centered.
• Bottom-aligned — Bottom-left quadrant for a cinematic feel.
• Dramatic — Maximum heading size with subtitle as a small caption.

Code slides

Slides containing a code block are rendered with a dedicated layout — monospaced font, code colors, and sizing tuned to fill the slide.

Layouts

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

Table slides

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

Layouts

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

Chart slides

Slides containing a chart are rendered as themed data visualizations matching your theme's colors and fonts.

Layouts

• Default — Full-width chart.
• Centered — Chart with horizontal margins.

Quote slides

A slide containing a blockquote is rendered with large, decorative typography.

Layouts

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

Diagram slides

Slides containing a diagram render flow charts and architecture visualizations with your theme's colors.

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

Choose a theme

Typedeck includes 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.
• Slide size 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 — Clean (Swiss International, the professional default), Warm (editorial serif warmth), Pastel (soft and friendly), Pitch (startup investor deck), Contrast (high-contrast accessible, WCAG AAA).

Dark — Ink (true dark mode, OLED-friendly), Elegant (gold on charcoal), Neon (cyberpunk terminal), Mono (developer focused, SF Mono).

Bold — Bold (neubrutalism-lite punch), Gradient (aurora color flow), Swiss (modernist grid design), Sunset (warm coral gradient).

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, 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 protecting it with a password. Locked themes can still be applied to any deck — they just can't be changed.

Set a password

Open the theme editor for your custom theme. In the header bar, click the lock icon and choose Set Password. Enter a password and confirm it. Once set, a lock badge appears on the theme in the Theme Gallery.

What locking prevents

• Editing any theme property (colors, fonts, logo, spacing, sizes).
• Deleting the theme from the Theme Gallery.
• Exporting the theme file (to prevent extracting and re-importing without the lock).

Applying a locked theme to a presentation works normally. Presenters see and use the theme — they just can't modify it.

Unlock to edit

Click the lock badge in the theme editor header and enter the password. The theme stays unlocked for the current editing session. Close the editor and it locks again automatically.

Remove the password

While the theme is unlocked, click the lock icon and choose Remove Password. The theme becomes a normal editable custom theme.

Duplicating a locked theme

Duplicating a locked theme requires the password. The resulting copy is always unlocked, so you can use it as a starting point for a new variation.

Share a branded theme

Design a theme that matches your brand, lock it, and share it with your team. Everyone gets consistent, on-brand slides without needing to make design decisions.

The workflow

1. Design the theme in Format > Theme Editor — set your brand colors, fonts, logo, and spacing.
2. Lock it with a password so the theme can't be modified.
3. Click Export to save a .typedeck-theme file.
4. Share the file with your team via email, Slack, or a shared drive.
5. Team members choose Format > Import Theme to add it to their Theme Gallery.

What the team gets

Everyone who imports the theme gets exactly what you designed: colors, fonts, heading style, logo, spacing, and background images. They can apply it to any deck and present with it, but they cannot change how it looks.

Updating a branded theme

Unlock the theme with the password, make your changes, re-export, and distribute the updated file. Team members import the new version — it appears as a separate theme, so they can switch at their own pace.

Tips

• Name the theme clearly (e.g., "Acme Corp 2026") so team members know which version they have.
• Include a logo — it appears automatically on every slide.
• Test across all layout types in the editor's live preview before exporting.

Start a presentation

Present your slides in full screen with speaker tools, transitions, and staged reveal.

Presentation modes

Typedeck offers several ways to present:

• Play from Start (⇧⌘P) — Full-screen audience view from the first slide.
• Play from Current Slide (⌥⌘P) — Full-screen audience view from whichever slide is selected in the editor.
• Presenter View (⇧⌥⌘P) — Full-screen presenter view with speaker notes, timer, and next slide preview.
• Present on Two Screens — Opens two windows: one for the audience and one for presenter tools. Drag the presentation window to an external display.

Switching modes during a presentation

Move your mouse to reveal the controls bar, then click the … button to switch between Presentation View and Presenter View.

Screen blanking

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

Presenter view

Your private control center during a presentation — showing everything you need while your audience sees only the slides.

Layout

• Left panel — Current slide, reveal step counter, and speaker notes in large teleprompter-style text.
• Right panel — Next slide preview, elapsed timer with play/pause/reset, navigation controls, and End Presentation button.

Multi-monitor

With a secondary display, Typedeck shows the presentation on the primary display and the presenter view on the secondary. Toggle with P.

Slide jump

Type any number during a presentation and press Return to jump directly to that slide.

Staged Reveal

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

Reveal modes

• Off — Default. All content visible immediately.
• Bullets — Text lines appear one by one. Objects are visible immediately.
• Steps — All elements appear one by one in document order.

Set the reveal mode

Open the Layout Editor (⌥⌘Q) and choose a mode in the Reveal section.

During a presentation

When reveal is active, pressing →, Space, or Return reveals the next element. The presenter view shows a step counter.

Transitions

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

Available transitions

• None — Instant cut.
• Fade — Cross-fade.
• Slide — New slide slides in from the edge.
• Push — New slide pushes the old one out.

Set transitions

Open the Layout Editor (⌥⌘Q) and choose a transition for that slide. The deck-wide default can be set in the sidebar settings.

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 slide size (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 Google Slides

Send your presentation directly to Google Slides as an editable document, without saving and uploading a file yourself.

How to export

Choose File > Export As > Google Slides. The first time you export, Typedeck will ask you to sign in with your Google account. After that, exports go straight through.

How it works

Typedeck builds a PowerPoint file behind the scenes, uploads it to your Google Drive, and converts it into a native Google Slides document. The result opens automatically in your browser.

Editability

Text, shapes, and tables arrive as editable objects. Slides with complex layouts — like diagrams or charts — may arrive as images. Typedeck shows you a summary before exporting.

When to use Google Slides

• Sharing with people who collaborate in Google Workspace.
• Presenting from a browser on any device.
• When the recipient needs to comment on or edit the slides.

Speaker Notes PDF

Export a printable PDF with each slide shown as a thumbnail alongside its speaker notes — perfect for rehearsal or as a handout.

How to export

Choose File > Export As > Speaker Notes. Pick a save location and Typedeck generates a letter-size (8.5″ × 11″) PDF.

What you get

Each page contains a high-quality slide thumbnail at the top, a "Slide N" label, and the slide's speaker notes as readable body text. Slides without notes show a "No speaker notes" placeholder.

When to use it

• Printing a script to bring on stage or keep at the podium.
• Reviewing notes before a talk without opening the full app.
• Sharing annotated slides with a co-presenter or coach.

Tips

Add speaker notes with the <!-- NOTES: ... --> syntax at the end of a slide, or use the notes drawer (View > Notes, ⌃⌘N). The PDF uses your current theme, slide numbers, and footer settings.

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. The image dimensions match your deck's slide size.

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.

Export to Obsidian

Save your presentation as an Obsidian-compatible Markdown note with YAML frontmatter and callout syntax, ready to drop into any vault.

How to export

Choose File > Export As > Obsidian Note. A save dialog appears — navigate to your Obsidian vault (or anywhere else) and click Save. The file saves as a standard .md file.

What the exported file contains

• YAML frontmatter — Title (from your first slide heading), today's date, and a typedeck tag. Obsidian displays these as note properties.
• Slide delimiters — --- between slides, preserved as-is.
• Quotes as callouts — Blockquotes are converted to Obsidian's > [!quote] callout syntax, which renders as styled callout blocks in Obsidian.
• Everything else — Speaker notes, code blocks, tables, images, and formatting are kept as standard Markdown.

Round-trip workflow

Typedeck and the Obsidian plugin support a two-way workflow:

• Obsidian to Typedeck — Use the Typedeck plugin's "Open in Typedeck" command or File > Import > Obsidian Note in Typedeck.
• Typedeck to Obsidian — Use File > Export As > Obsidian Note and save into your vault.

The exported file is a clean Obsidian note. You can edit it further in Obsidian and send it back to Typedeck at any time.

The Typedeck plugin for Obsidian

The Typedeck community plugin adds presentation-aware features to Obsidian:

• Slide break badges — --- delimiters show a "Slide N" badge in the editor so you can see slide boundaries while writing.
• Live slide count — The status bar shows how many slides your note contains.
• Open in Typedeck — Sends the current note to Typedeck with one click, automatically converting callouts, frontmatter, and other Obsidian syntax.
• Format validation — Checks your note against Typedeck's format rules and shows actionable warnings.
• Insert speaker notes — Adds a <!-- NOTES: --> template at your cursor (⌘⇧N).

Install it from Settings > Community plugins in Obsidian by searching for "Typedeck".

AI Generated Text

Describe what you'd like the slide to say and Apple Intelligence generates the content — headings, bullet points, and all.

How to use

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.

Requirements

Requires macOS 26 or later with Apple Intelligence enabled. On unsupported systems, this command is hidden from the slash command palette.

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.

AI Diagrams

Describe a diagram in plain language and Typedeck generates it for you using Apple Intelligence.

How to use

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. Edit the generated code afterward to fine-tune it.

Requirements

Requires macOS 26 or later with Apple Intelligence enabled. On unsupported systems, this command is hidden from the slash command palette.

AI Images

Generate custom images on-device using Apple's Image Playground and insert them directly into your slides.

How to use

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.

Requirements

Requires macOS 15.1 (Sequoia) or later with Image Playground. On unsupported systems, this command is hidden from the slash command palette.

Privacy

Image generation happens on-device through Apple Intelligence. Your prompts and generated images are never sent to external servers.

Claude Code Plugin

Generate entire presentations from a text prompt using the Typedeck plugin for Claude Code and Claude Cowork.

What it does

The Typedeck plugin for Claude lets you describe a presentation in plain language and get a complete slide deck — with charts, code blocks, diagrams, tables, quotes, speaker notes, and more. Typedeck handles layout and theming automatically. The plugin works in both Claude Code and Claude Cowork.

Installation

Install the plugin from within Claude Code:

`` /plugin install typedeck ``

Usage

Run the skill explicitly:

`` /typedeck:generate-slides A 10-slide investor pitch for a developer tools startup ``

Or just ask Claude naturally — the plugin activates when you mention creating a presentation or slide deck:

• "Create a presentation about our Q3 results"
• "Make me a Typedeck deck covering the basics of Kubernetes"
• "Generate slides for my team standup"

What you get

Claude writes a .md file you can open directly in Typedeck. If you request a specific theme or include images, it creates a .typedeck package instead.

Supported content

The plugin can generate slides with any content type Typedeck supports:

• Text and bullet lists
• Code blocks with syntax highlighting
• Data tables
• Charts (bar, line, pie, area)
• Mermaid diagrams
• Blockquotes with attribution
• Speaker notes and build animations
• Split layouts (text alongside an object)
• Two-column text layouts

Themes

Request any built-in theme by name — for example, "use the pitch theme" or "make it editorial." Available themes include default, warm, editorial, pastel, pitch, contrast, scholar, elegant, folio, ink, memphis, neon, sunset, swiss, mono, gradient, moscone, and bold.

Requirements

Requires Claude Code or Claude Cowork with plugin support.

ChatGPT Custom GPT

Generate entire presentations by chatting with the Typedeck Slide Generator in ChatGPT.

What it does

The Typedeck Slide Generator is a custom GPT for ChatGPT that creates complete slide decks from a conversational prompt. Describe what you need and it generates a downloadable .md file you can open directly in Typedeck.

How to find it

• In ChatGPT, click Explore GPTs in the sidebar (or visit the GPT Store)
• Search for Typedeck Slide Generator
• Click the GPT to open it — no installation required, it runs directly in ChatGPT

You can also access it from a direct link shared on the Typedeck website.

How to use

1. Open the Typedeck Slide Generator in ChatGPT
2. Describe your presentation — for example, "Create a 12-slide pitch deck for a developer tools startup"
3. ChatGPT generates the slides and provides a downloadable .md file
4. Download the file and open it in Typedeck — layouts and theming are applied automatically

You can iterate on the result by asking ChatGPT to add slides, change content types, adjust tone, or restructure sections.

Supported content

The custom GPT can generate slides with any content type Typedeck supports:

• Text and bullet lists
• Code blocks with syntax highlighting
• Data tables
• Charts (bar, line, pie, area)
• Mermaid diagrams
• Blockquotes with attribution
• Speaker notes and build animations
• Split layouts (text alongside an object)
• Two-column text layouts

Themes

Request any built-in theme by name — for example, "use the pitch theme" or "make it editorial." When you request a theme, ChatGPT creates a .typedeck package with the theme preset applied.

Requirements

Requires a ChatGPT account (free or paid). The custom GPT uses Code Interpreter to generate downloadable files.

Settings

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

General

• Appearance — System, Light, or Dark.
• Default Theme — The theme applied to new presentations.

Editor

• Preset — Editor styling preset.
• Font Size — Text size in the editor.
• Line Width — Text column width.

Export

• PDF Quality — Rendering quality for PDF exports.

Grid view

See all your slides laid out in a grid for a bird's-eye view of your entire presentation.

Press ⌥⌘G or click the grid button in the toolbar. Useful for checking your deck's flow, spotting inconsistencies, and jumping to any slide.

Terms of Service

The terms that govern your use of Typedeck. By downloading Typedeck from the Mac App Store, you agree to these terms.

Your agreement with us

When you download Typedeck from the Mac App Store, you enter into a license agreement directly with Testify LLC, the maker of Typedeck. Tapping "Get" or "Buy" on the App Store is how you signify your assent — there is no separate in-app acceptance step.

The full Terms of Service are available at typedeck.app/terms. Please read them before using the app.

What the terms cover

• The license we grant you to install and use Typedeck on your devices.
• Your rights to the presentations and content you create with Typedeck — you own your work.
• Disclaimers, limitations of liability, and the governing law for any disputes.
• Rules for third-party content used inside the app, such as images sourced from Unsplash.

Questions

If anything in the Terms of Service is unclear, contact us at support@typedeck.app.

Privacy Policy

How Typedeck handles your data. The short version - your presentations stay on your Mac, and we don't collect analytics or telemetry.

Privacy at a glance

Typedeck is a local-first Mac app. Your presentations, images, and speaker notes are stored on your own device in .typedeck files. We do not collect analytics, telemetry, or usage data.

The full Privacy Policy is available at typedeck.app/privacy.

When the app talks to the network

Typedeck makes network requests only when you explicitly use a feature that requires one:

• Unsplash image search — If you use the built-in Unsplash panel, your search query is sent to Unsplash's API. Unsplash may log the request per their own privacy policy.
• Notion import — If you connect Notion via File → Import from Notion, Typedeck uses Notion's official OAuth 2.0 flow to obtain an access token for your workspace. Search queries, page IDs, and page content you choose to import are sent to Notion's API on your action. Tokens are stored in your Mac's Keychain. You can disconnect at any time from Settings.
• Google Slides export — If you export to Google Slides, Typedeck uses Google's official OAuth 2.0 flow to obtain an access token scoped to files the app creates in your Google Drive (drive.file). The exported presentation content is uploaded to your Drive on your action. Tokens are stored in your Mac's Keychain. You can disconnect at any time from Settings.
• Help and support links — Opening links from the Help menu sends you to our website in your default browser.

That's it. There is no account, no sign-in for Typedeck itself, and no background data collection.

Questions

For privacy questions or requests, contact privacy@typedeck.app.

Editing shortcuts

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

Formatting shortcuts

Keyboard shortcuts for text formatting and paragraph styles.

Presentation shortcuts

Keyboard shortcuts for presenting and navigating slides during a presentation.