Write and format chapters and notes

All help articles

Open a chapter or note from the file tree, a tab, project search, or the command palette (Cmd+K, or Ctrl+K on Windows), then start typing.

Format text

The formatting toolbar at the top of the editor holds bold, italic, highlight, alignment, links, and more. Use Text style, Alignment, and Lists for their grouped controls. Secondary commands and any controls that do not fit are in More formatting, the three dots at the end of the row.

When you select text, a smaller toolbar appears just above the selection with highlight colors and icons for Comment, Thesaurus, and Play aloud. Hover over an icon to see its name. Near the top of the editor it opens below the selection instead. On a phone it sits along the bottom of the editor. It closes when you click or tap anywhere else.

Links in chapters and notes are blue and underlined.

Select the words to link, or place the cursor where the link should go, and choose Link in the formatting toolbar. Type a web address, or link another file in the project: under Or link a file, type part of its name and choose it from the list. A link to a file shows the file's name instead of an address; choose Change to type a web address instead.

Clicking a link to a web page opens it in a new tab. Clicking a link to a file opens that file in the same tab; hold Cmd (Ctrl on Windows) as you click to open it in a new tab instead. A link to a quotation also selects the quoted words. If a linked file has been deleted, the link does nothing, and editing it says the file is no longer in this project.

Insert blocks with the slash menu

Type / at the start of a line or after a space, then keep typing to filter:

  • Heading 1, Heading 2, Heading 3
  • Bullet list, Numbered list, Checkbox list
  • Quote
  • Table
  • Section break for a scene break
  • Toggle list, a collapsible section
  • Date for today's date, written out in full
  • Text conversation, Email and Letter, described below
  • In a note, 2 columns, 3 columns and 4 columns, described below

Use arrow keys and Enter to choose an item.

Chapters and notes differ

  • Chapters are manuscript writing. A chapter can start with an Epigraph. With the cursor in an epigraph, choose Add attribution below Epigraph in More formatting to name its source under the quote. Press Shift+Enter to add another line. Press Enter or click away to save it, or Escape to cancel your edit; clear it to remove it. Turning the epigraph back into ordinary text keeps the attribution as the next paragraph.
  • Notes are for research and planning. You can drag a note's blocks by their handle to reorder them, and set blocks side by side in columns.

Images can't go inside a chapter. To keep an image with your project, choose Add file or folder, then Image, and it appears in the file tree.

Put blocks side by side in a note

In a note, type / and choose 2 columns, 3 columns or 4 columns, then write in each column. To move a block into a column or out of one, drag it by the handle on its left and drop it where you want it. A column holds text, headings, lists, quotes, toggle lists, section breaks and images. Tables, emails, letters and text conversations need the note's full width: the slash menu leaves them out while the cursor is in a column, and one dropped over a column lands above or below the columns instead.

With the cursor in the columns, a toolbar appears above them:

  • 2 columns, 3 columns and 4 columns change how many columns there are. Going to fewer moves the writing in the columns that go to the end of the last one kept: from four to two, the third and fourth columns' writing moves to the end of the second.
  • Even widths makes the columns the same width again.
  • Remove columns puts everything back in one column, in reading order: the first column, then the next.

To change the widths, drag the line between two columns; the widths show as you drag. With that line focused, the left and right arrow keys move it too. Neither column beside the line gets narrower than a fifth of their combined width.

To move all the columns at once, drag the handle in the margin beside them. In a narrow pane or on a phone the columns stack, first column on top, and go back side by side when there's room. Four columns sit two by two when there's room for two but not four.

Moving writing while someone else types in it would lose their words. If another writer's cursor is in a block you drag, or in columns you merge or remove, Authorship leaves everything where it is and says who is writing there. Try again when they've moved on.

Find your way around a long note with the outline

Once a note has two or more headings, an outline of them sits beside the note, on the right. It lists the note's headings in reading order, indented by level, with headings in columns included. Headings inside a toggle list stay out of it. Click a heading in the outline to scroll the note to it. As you scroll, the outline marks the section you're reading.

The outline button sits at the right end of the formatting toolbar. Choose Hide outline to put the outline away and Show outline to bring it back. Your choice applies to every note in this browser.

In a narrow pane or on a phone there's no room beside the note, so choose Outline at the end of the toolbar to open the list, then choose a heading to go to it.

Chapters don't have an outline.

Write a text conversation

For texts or DMs between characters, choose Text conversation in More formatting or the slash menu. The conversation starts with one message: type the sender's name, press Enter, and type the message. Add message, or Cmd+Shift+Enter (Ctrl+Shift+Enter on Windows), starts the reply from the other side. Point at a message, or put the cursor in it, to see its buttons beside it: Switch side (the arrows) moves it to the other side. Sent messages sit on the right in colored bubbles, received ones on the left, and every message keeps its sender's name.

In a message, Enter starts a new paragraph, and Enter in an empty last message leaves the conversation. Cmd+Enter (Ctrl+Enter on Windows) continues writing below from anywhere in it. Backspace and Delete at the edge of a name or message only move the cursor. Remove message deletes a message; a conversation keeps at least one. A conversation can't be turned back into ordinary text.

Write an email or a letter

More formatting has Email and Letter, and the slash menu lists Email and Letter.

  • An email has From, To and Subject lines, an optional date, then the message.
  • A letter has an optional dateline, a greeting such as "Dear Jo,", the letter itself, and a sign-off.

The From, To, Subject, date, dateline and greeting lines are plain text on one line. Press Enter to move to the next line. In the message or letter, Enter starts a new paragraph. In the sign-off, Enter at the end leaves the letter, and Enter anywhere else starts a second line for a signature. On the From, To, Subject, date, dateline, greeting and sign-off lines, Backspace at the start and Delete at the end only move the cursor, so those lines never merge or disappear. Press Cmd+Enter (Ctrl+Enter on Windows) to continue writing below.

The buttons for an email or letter show above it while you point at it, while the cursor is in it, or while it's still empty. Add date and Add dateline add those lines. Remove date and Remove dateline only work once the line is empty, so clear its text first.

Convert to text turns an email or letter into ordinary paragraphs. Every line you wrote stays, with its formatting and comments; empty lines are left out. Undo brings the email or letter back. If someone else is typing in it when you convert it, words they type before your change reaches them can be lost.

Rename from the title

Edit the title at the top of the chapter or note. It saves on its own, and the file tree and tabs update to match.

Write on a phone or tablet

On a phone, and on a tablet held upright, each part of a project is its own page. A bar at the bottom of the screen switches between Home, Files, Chat, and More:

  • Home names the project, picks up where you left off with Continue writing, and lists the files you have open. Projects at the top goes back to your projects.
  • Files holds the file tree. The plus at the top adds a file or folder.
  • Chat opens the chat.
  • More holds the manuscript, Story Atlas, beta reading, publishing, search, comments, the thesaurus, the theme, and help.

Opening a chapter or note opens the writing page. Chat and Writing actions (the three dots) sit at its top. Writing actions holds the file's own actions, such as Document actions, and search, comments, and the thesaurus.

The back button at the top left, your browser's Back, and swiping in from the left edge all go back one page. The bar hides while the keyboard is open.

To open Authorship like an app, choose More, then Install Authorship, and follow the steps for your device.