Features

What TalkWeaver does differently

TalkWeaver is built around a text outline. Each section below names something it does that most presentation software does not, says where it is in the app, and links to the feature page that covers it.

Outline first

A talk is a text outline in its own folder, and every picture, sound and video it uses sits in that folder. You can open it in Finder like any other folder. The slides, the handout, the presenter view and the venue screen are all made from the outline.

A heading with two hash marks starts a section, and TalkWeaver makes a title page for it, as in the picture below.

You can package a talk as a single HTML file with Share › HTML presentation, or share it through Cloudflare with Share › Share for comments.

Read more: Every heading is a slide

The TalkWeaver editor with the sample talk Ten years of public bike hire, with the caret on the heading of a section: the slide list on the left, the Markdown outline in the middle, and on the right a preview of the section’s title page, which shows only the section name on a tinted background.
A heading that starts a section gets its own title page. The preview shows the title page of the section The decade in numbers.

Layouts built from the outline

Each heading in the outline becomes a slide, and a word in curly brackets on the line under it, such as {statement}, picks its layout. You type the headings and the slides are made from them.

Press ⌘L to see your own slide in each layout and pick one. A slide whose text does not fit its layout is flagged, and the text is not shrunk to fit.

Read more: A registry of designed layouts

The layout picker over the sample talk Ten years of public bike hire, on a list slide of four short points: Recent, Suggested and layouts grouped by purpose, with Cards previewed on the slide above.
The picker shows your own slide in each layout.

No positioning of images

You do not position images. The layout places them, in image grids, carousels, window frames and beside text. You choose the layout, and the picture follows it.

Several screenshots on one slide sit in one row in window frames. The action bar above the editor has a button for images.

Read more: A registry of designed layouts

The slide grid of the sample talk Ten years of public bike hire at its Stations section: the section title page and five picture slides of bike-hire stations and cycle lanes, laid out as galleries of three, two, four, six and three, each with captions.
Galleries of three, two, four and six pictures. The outline writes only the pictures and their captions, with no position.

Built-in icons

⌘I opens the icon picker, which searches a built-in set of icons and brand logos and pins the one you choose to the list item where the caret is. Icon lists and cards show the icon beside each item.

The action bar above the editor has an icons button, and the icon rows and cards keep their icons at a readable size.

Read more: The Inspector and the action bar

The icon picker open on a list item in the sample talk Ten years of public bike hire, with the search term light typed and matching icons shown: a bulb, a lamp, a lighthouse and others.
The icon picker, searched for light.

⌘S searches the slides of every talk in every open vault at once, and inserts the one you pick into the talk you are writing. ⇧⌘S opens the same picker with the cursor in Find a talk.

Slide search also covers the text inside images on macOS.

Read more: Reuse slides between talks

The Slide Browser searched for station: five slides from the sample talk Ten years of public bike hire, among them galleries of photographs, with one chip for each open vault.
Search finds slides across talks and vaults, with a chip for each open vault.

Polls and live presenting

You write polls in the outline: single choice, multiple choice, open answer, rating, ranking and matrix. Q opens a poll for the room, and K opens a quick poll without a prepared slide.

When you go live, the audience follows on their phones, and a venue computer can show your slides from a link. Live features run in your own Cloudflare account, which you set up in Settings → Cloudflare.

Read more: Live polls

The presenter view of the sample talk Ten years of public bike hire before going live, on a slide with a pie chart, and under it a quick poll composed on that slide: the question How do you usually get to work, Single choice, Results shown as they arrive, and the Open poll button; the top bar reads Not live.
A quick poll ready to open, before going live. The presenter notes that no live session is running.

Control while you present

The first and last slides are made from the talk’s metadata, and a link written as [QR: …] becomes a QR code. In the presenter you can put an instant slide on every screen, with text, a link and its QR code, or a countdown for a break or a discussion. Polls and questions from the room need a live session.

Read more: Instant slides during a talk

Sharing

A talk can be exported as a single HTML file that runs in any browser. Share › Handout builds a handout from the outline, and Share › Publish to Cloudflare puts it online at a link you can give out.

Share › Share for comments sends a colleague a private link, and their notes and proposals arrive in a Feedback rail beside your editor. Publishing and sharing run in your own Cloudflare account, and TalkWeaver has no server of its own that holds your talks.

The example is the sample talk exported with Share › HTML presentation. It is one HTML file of about 5.6 MB that opens in any browser and made no network requests when tested. The arrow keys, Space, Home and End move between slides, Overview lists the slides with a search box, and the charts, pictures and the QR code are drawn on the slides. The embedded page is interactive once you click Interact, and Open Presenter View opens a presenter window with a clock.

See an example HTML export · Download the file from GitHub

Read more: A handout for each delivery

The TalkWeaver editor with the sample talk Ten years of public bike hire and the Share menu open: Handout (reveal in Finder), HTML presentation (reveal in Finder), Publish to Cloudflare and Share for comments.
The Share menu. The handout page it builds is shown on the Presenting page.

Reuse and tracking of old slides

When you reuse a slide in another talk, TalkWeaver records where it is used and keeps its versions. A Pathway is a ticked list of slides from the same talk, such as a 20-minute version of an hour-long talk, and a slide you improve is improved in every Pathway that includes it.

Press ⌘⇧U on a slide, the command Where used and versions, to open a sheet that lists every talk using it and its saved versions.

The Importer turns PowerPoint decks into outline slides you can reuse the same way.

Read more: Tick slides instead of copying them

The where used and versions sheet for a slide in the example talk Garden notes: it is used in two presentations, Garden notes and The Saturday market, and has two versions.
The Where used and versions sheet (⌘⇧U) for a reused slide.

Visuals and rich interactive pages

The Insert menu makes a table, chart, mindmap or diagram from plain text. An HTML page kept in the talk’s folder, added with [Embed: …] or [Simulation: …], runs on its slide in a sandbox cut off from the app and your files.

Four more slide designs simulate an AI chat and a terminal, with their parts shown step by step.

Read more: Interactive pages on slides

The presenter view of the sample talk Ten years of public bike hire: the current slide holds an interactive chart of trips by hour, switched to Weekend, beside a line of text.
An interactive chart page working in the presenter’s Current pane, switched to Weekend.

Built-in recording

Recording starts from the presenter view with ⇧R, and the recording is kept with the Run for that delivery, together with its polls and questions. Tools › Studio plays it back with the slides in step.

If the title slide has been up for at least a minute and you move to slide 2, a small notice offers to start recording.

Read more: Record the room

Agent friendly

A talk is a Markdown file in a folder, so a coding agent can read and edit it like any other text file. TalkWeaver setup sets up Cloudflare, recording storage and transcription from the command line, without opening a window.

The set-up guide for agents is inside the app, and the token is read only from a hidden prompt or standard input, never from an argument.

Read more: Set up Cloudflare for publishing and going live