Writing Articles

Write on pages like a document: text that flows from page to page, with pictures, charts and drawings in it.

Applies To

livedocuments

An article is a kind of page to write on (Working with Pages). Where an infographic page is a sheet you lay out freely, an article page is for writing: a title, paragraphs, headings and lists, with pictures, charts and drawings sitting in the text. When the writing runs past the bottom of a page it flows onto a new one, and when it shrinks, the empty pages go again.

Starting an Article

  • On a new tab: the first page of a tab asks What Is This Page For? while it is still empty. Choose Article and the caret lands in the title. Choose Infographic, or start putting things on it, and it stays an infographic page.
  • After other pages: press the + after the last page (or the + at the end of the palette strip) and choose Article.
  • From a template: the Project Brief template (under Plans) starts a tab with a short project brief you can write over. Meeting Notes, Lesson Plan, Business Proposal, Design Doc, Status Report, Cover Letter, Product One-Pager, Research Report, Newsletter, Case Study and Onboarding Handbook are articles too, each written out with the tables, contents, footnotes, headers and footers a real one would use (Templates).

A page keeps its kind once you start: an article page cannot become an infographic page, or the other way round.

New to articles? Open the page's cog and press Show Me at the top of its panel for a short tour of writing, the page toolbar and the article's style, on your own page. Get Started, in the bar at the bottom of the editor, runs the same Pages Tour.

Writing

Click anywhere on the page to put the caret there and type. The writing sits inside the page's margins; there are no text boxes to draw.

  • Enter starts a new paragraph, Shift+Enter a new line in the same one.
  • Markdown shortcuts as you type: #, ## and ### for headings, - or * for a bulleted list, 1. for a numbered list, [ ] for a to-do, > for a quote, three backticks for code, --- for a divider. Backspace straight after undoes the shortcut.
  • Type / at the start of a line for the block menu: headings, lists, quote, code, divider, page break, a table, a table of contents, a footnote, pictures, charts and drawings, a callout and a sticky note.
  • Paste from a web page, Google Docs or Word: headings, lists, links, bold and italic come with it, and tables arrive as tables. Paste Markdown and it is turned into formatted blocks.
  • The Title names the document. While the document still has its starting name (such as "Untitled Article"), the Title you write in its first tab's article becomes the document's name. A name you gave it yourself is kept.
  • Find and replace words across every page with ⌘F: see Find and Replace.
  • Tab and Shift+Tab indent and outdent a list item.

The Formatting Toolbar

While you write, a toolbar sits at the top of the page, inside it: hover any article page and it shows there too.

An article page with its formatting toolbar along the top, and commented words tinted with their marker in the margin.
  • Style: Text, Title, Subtitle, Heading 1 to 3, Quote or Code. ⌘⌥1, ⌘⌥2 and ⌘⌥3 make a line a heading, ⌘⌥0 plain text again.
  • Bold, Italic and Underline (⌘B, ⌘I, ⌘U).
  • Colour: text colour and highlight, from the article's colours.
  • Link (⌘K): add, edit or remove a link on the selected words.
  • Lists: bulleted (⌘⇧8), numbered (⌘⇧7) or to-do (⌘⇧9), and indenting.
  • Alignment: left (⌘⇧L), centre (⌘⇧E), right (⌘⇧R) or justified (⌘⇧J).
  • More Formatting: strikethrough, inline code, superscript, subscript, clear formatting, and Article Style, which opens the article's Style. Its last line is the article's Word Count, with how long it takes to read and how easily it reads, as "840 words · 4 min read · Easy to read"; with text selected it reads the selection's, as "12 of 840 words · 1 min read · Plain English". Table cells and footnotes count, footnote numbers don't. Hover the line for the numbers behind it: the words a sentence on average, how many sentences run over 30 words, and the Flesch Reading Ease. When a sentence runs over 30 words, the line shows how many ("3 long"): pick it to select the next one, so you can split it, and pick it again to go on. How easily it reads is shown for writing in English; other languages get the length and reading time.
  • Insert: under Objects, an image or a bar, pie or line chart; under Blocks, a table, a table of contents, a footnote, a divider, a page break, a quote or a code block. A drawing, a callout and a sticky note are in the / menu.
  • Table, while the caret is in a table: rows, columns, the header row and Delete Table. See Tables in Articles.
  • Comment and Assign Action, with words selected outside a table (see below).

Pages That Grow

Writing flows from page to page like a word processor: when a page is full the next line starts on a new page, added for you, and pages the writing no longer reaches are removed. A heading never sits alone at the foot of a page: it moves over with the line after it. A page break (from Insert, or /) starts the next page early.

All the pages of an article share its size, orientation and background: change them from any of its pages and they all follow. The page navigator in the bottom-right corner, beside Undo and Redo, takes you to the previous or next page.

Pictures, Charts and Drawings in the Text

Anything you add from the palette, the toolbar's Insert or the / menu sits in the writing, and the text makes room for it.

  • A picture, chart, sticky note or the palette's table element sits on its own line by default. (A table from Insert or / is part of the text instead: see Tables in Articles.) Select it and the bar underneath chooses how it sits: In Line (on its own line, aligned left, centre or right), Wrap Left or Wrap Right (the text runs down beside it), or Float (in front of the text, anywhere on the page).
  • Drag it to move it: a blue line with a ring at each end shows where it will land between paragraphs; let go and it moves there. Or drag the grip at the left of its bar.
  • A drawing: drop a shape on the writing and it starts a drawing area, a space between the paragraphs to draw and connect shapes in with every tool. Drag its edges or corner to make it bigger or smaller. Whatever pokes past its edge is cut off, on screen and in exports.
  • When the writing above them changes, they move with the text, onto another page if they need to.

Comments and Actions on Words

Select some words, then press Comment (⌘⌥M) or Assign Action in the toolbar. The words are tinted (amber for a comment, blue for an action) and a small marker appears in the page's margin beside them, showing the comment count, or a tick for an action. Comments, mentions, assignees, due dates and the Inbox all work exactly as they do on shapes.

  • Click the marker, or the tinted words, to open the thread or the action.
  • The marker moves with its words as you write above them. Several on the same line stack down the margin.
  • Delete the words and the comment or action goes with them (Undo brings both back). Delete the marker and the tint goes.
  • Exports leave the markers and tints out.

The Article's Style

An article page's title bar, beside its cog, holds three buttons. Each opens a popover (a sheet from the bottom on a phone):

  • Style: first Tab Style, which opens the whole tab's look (theme, finish, fonts and canvas: see Changing the Theme), then the article's own: a Look to start from (Clean, Classic, Report, Notebook or Bold), the Accent colour and whether headings take it, the Margins and Page Numbers, and the Header and Footer (see Contents, Headers and Footers).
  • Text: the Fonts for headings and body, then Text Size, Line Spacing, Paragraph Spacing and Lines Under Text (under the title, or under every heading).
  • Background: the paper colour and pattern.

The cog's panel keeps the Page settings (size and orientation, for every page of the article) and the page's actions.

Hover any choice to preview it on the page; press it to keep it. With the Lines pattern from Background, an article page becomes lined paper, the lines sitting under the text.

Exporting and Presenting

Writing Together

Collaborators see each other's writing as it is typed, and several people can write in the same article at once. To keep two people from typing over each other, one person writes a paragraph at a time:

  • When someone types in a paragraph, a heading, a list item or a table cell, it is theirs while they write. Everyone else sees it outlined in that person's colour, with their name in the margin beside it. Hover it to read who, for example "Sam Lee is writing here".
  • You can still read it, select and copy its text, and comment on it, and you can type anywhere else in the article. Typing into it waits until they move on, and a short notice says who is writing there.
  • It frees again as soon as they move to another paragraph, stop typing for a few seconds, or leave the document.
  • In a table, people can type in different cells at once. Adding or removing a row or column waits while someone is writing in one of its cells.

AI assistants and scripts wait their turn too: a change that would write into a paragraph someone is typing in is turned away until they move on. See Errors and Rate Limits.

Good to Know

  • Participants can write in an article (paragraphs, lists, code and the cells of a table) but not insert anything, format it or change its pages; an Editor's screen adds any pages their writing needs. Viewers only read. Nobody can edit an article on a locked tab or a locked page.
  • On Windows and Linux, read Ctrl for ⌘ and Alt for ⌥ in the shortcuts above.

Was this article helpful?

Still need help?

Try Troubleshooting, or tell us what you were trying to do.

Contact us