Skip to main content
All docs

Getting started

The editor and desk

How to use the writing editor and your desk.

The editor is where you write. Open it from the home page or from any exercise. Your work saves automatically as you type, and if a piece is already published, your edits stay private until you publish them. See Saving and recovering your work for the details.

For a tour of the toolbar, formatting and the ruler, find and replace, the More menu, your desk panel, focus mode, typewriter mode, the outline, and page breaks, see Finding your way around the editor.

Your desk

Your desk is your personal library of everything you have written in Inkbreaker: drafts, published pieces, and exercise submissions. Reach it from the main navigation.

The list view shows one row per piece with where it stands, how long it is, and when you last worked on it. Sort by any of those, filter by status, and see word totals on every folder and on your desk itself. Some older pieces show a dash rather than a zero until their count is calculated.

All work and Unfiled

Above your folders sit two views of everything.

All work is every piece you have, whether it is filed in a folder or not. Unfiled is only the pieces that are in no folder at all.

These are views, not folders. You cannot put something in them and you cannot delete them; they are two ways of looking at the same pieces. You cannot name a folder “All work” or “Unfiled”.

Who can read a piece

Every row starts with a globe or a crossed-out globe: shared or private.

Select it to see how the piece is shared:

  • Only you. Nobody else can open it. Collaborators you have invited still can.
  • Going out with a date. Scheduled to publish, and private until then.
  • Held by moderation. It did not go out, so nobody can read it. Editing it and sharing again sends it back for review.
  • Anyone can read it. Published, and listed in the Inkbreaker Library and in search.
  • Anyone with the link. Published, but kept out of the Inkbreaker Library and search.

The List it in the Inkbreaker Library switch moves a piece between those last two. Everything else about sharing lives in the editor’s Sharing menu, where you choose who can read the piece and where it is published. See Publishing your work.

Finding where a piece lives

A search result does not say where a piece sits. Open the row’s … menu and choose Go to location, and your desk jumps to the folder holding it. If a piece is filed in more than one folder you pick which one; if it is filed nowhere you land in Unfiled.

Once you are inside a folder, the trail above the list names the folders above it, so a folder three levels down says so. Select any step to go back up.

Put your pieces in your own order

Choose My order from the sort menu and a handle appears on every row. Drag a piece where it belongs and it stays there, in that folder and everywhere else you look.

The handle works from the keyboard too: tab to it, press space to pick the piece up, move it with the arrow keys, and press space again to set it down.

Dragging is offered only under My order.

Breaking one piece into chapters

A manuscript you drafted in one long document can be cut into chapters without retyping anything. Open the piece’s … menu and choose Break into chapters.

Inkbreaker reads the draft and shows you what it would produce before it produces anything: the chapter titles, in order, with their lengths. If it guessed the wrong level, choose a different one and the preview redraws. Chapters can also be marked by a labeled line (“Chapter Seven”) or a scene separator rather than a heading.

You can name a folder to hold the results, which is prefilled with the manuscript’s own title. The original piece is kept; the chapters are new pieces alongside it.

It is the same operation the import wizard uses.

Combining pieces into one

The reverse, for when chapters should become a single document: select the pieces on your desk, then choose Combine into one piece from the selection toolbar.

The order is the order you see on your desk, so set the sort you want first, including My order if you have arranged them by hand. You are shown the running order and the combined length before anything is written, and the originals are kept.

Where a piece is out in the world

If you use the submission log, a piece that is out somewhere carries an Out mark on your desk, and one that has been accepted carries Taken.

Only those two are shown.

Series

Open a series from Series in your desk and it gets its own page, with four views of the same book: Contents, Outline, Drafts, and Audience. See Drafts and the outline.

Formats for what you write

Every format is there in every piece: headings and quotes, a screenplay’s scene headings and dialogue, a poem’s refrain, an article’s kicker and byline, callouts and more. The piece’s writing type decides which come first in the format menu and the slash menu, so a screenplay opens with its script elements and a novel with chapter headings and epigraphs. The rest wait under More formats, and searching finds any of them. To change what a piece is, change its writing type in the piece’s settings.

Formatting

File › Formatting sets the piece’s font, size, line and paragraph spacing, and page margins, and a ruler above the page lets you drag those margins and per-paragraph indents. Those choices belong to the piece, so they carry into the published view and into Word, PDF, and other exports. File › Page & view holds the settings for your own screen instead: your text size, your reading font, typewriter mode, and the editor theme. Those never change the piece. The full walkthrough is in Finding your way around the editor.

Small caps sets lowercase letters as small capitals, as in 9 a.m. Select the words and choose Small caps on the format bar, or press Ctrl+Shift+K (Cmd+Shift+K on a Mac). On a narrow screen it is under More formatting. Capital letters keep their full size. Small caps carry into the published piece, EPUB, print, and Word.

Tidy spacing on the format bar turns double spaces into one and removes spaces at the start or end of a paragraph, in the selection or, with nothing selected, the whole piece. On a narrow screen it is under More formatting. Code and poems keep their spacing. Undo puts the spaces back.

Slash commands

Type / in the editor and a menu appears. The options are writing formats, not generic document tools: code blocks and spreadsheet options are not in it.

Linking to your own writing

Type @ and the picker opens. Alongside your world’s characters, places, timeline events and dictionary words, it lists Your writing: any other piece in your desk. Pick one and the editor drops in a link carrying that piece’s title.

Search by one distinctive word rather than the whole title. Typing @Letter finds “Letter to Bilbo”; the picker closes at a space, and a full multi-word title does not match.

The link keeps working when the piece is renamed, and readers can follow it. It survives export too: in Markdown it becomes an ordinary link, and in an EPUB it points at the piece’s page on the web.

A table of contents inside a piece

Insert a Table of contents block from the slash menu and it lists the piece’s headings as you write, nested by level. Click a line to jump to its heading. Under How the list looks, choose Plain or Numbered (1, 1.1, 2). On the published page, in an EPUB, in a PDF, and in a Word document, each line is a working link that jumps to its heading. Headings also get their own anchors for linking to a section from elsewhere.

This is the contents list inside one piece. Assembling a whole book with a front-matter contents page is a separate feature, covered in Exporting your book.

Grade your draft

Open the Tools panel from the More menu and choose Check with the Meridian to run the prose engine against your current draft. It grades the whole piece, not a snapshot, and shows the same report you get after an exercise: your metrics, how each one compares to the benchmark for the writing type, and a short plain-English summary. Pick a different writing type at the top of the panel if you want to grade against another genre. Grading does not change your piece and does not award XP. You were already awarded XP for writing it.

The report can also show the advanced metrics (emotion, coherence, originality, and sentence patterns) and a per-piece trend on the History tab. Checking a draft does not use up your exercises. For what each number means, see How the engine works and What each metric means.

Drafts

Drafts are private until you publish them. You can keep a draft as long as you like, submit it as an exercise, or publish it to the community feed. Publishing does not submit it as an exercise. Those are separate actions.

Moving between pieces

You do not have to leave the editor to open another piece. Select Desk in the toolbar for a panel that lets you jump between your work by favorite, recent, folder, world, or series, and star the pieces you return to most. Switching saves the piece you are leaving first. The full tour is in Finding your way around the editor.

Working in several pieces at once

The pieces you have open stay open. On a wide screen they sit in a strip above the editor; on a phone, on a narrow window, and in the desktop app at a narrow width, they live behind one control in the header that shows the piece you are in and how many others are waiting. Select it for the full list.

A limit applies to how many pieces can be open at once; the editor tells you when you reach it.

For a larger set, use a collection, which the Desk panel opens piece by piece, or a workspace from Workspaces, which keeps a named set of pieces you can put away and open again together.

Only the piece you are looking at is a live editor

Only the piece on screen is open for editing and autosaving. The others keep your place: the title, and that you have it open. Moving to one of them loads it again, and a very long piece takes a moment.

Switching saves first

A switch saves the piece you are leaving before it moves. If that save cannot be made, the switch does not happen: you stay on the piece, and a message says why.

Closing a piece works the same way: it is never closed while its last save is still failing.

Pinning, and your other devices

Pin a piece and it stays at the front of the list and is never closed to make room for something else. When you are at the limit and open another piece, the one closed to make room is the one you have used least recently, and never a pinned one, and never one with unsaved work. If everything open is pinned or unsaved, the new piece does not open and a message says so.

Your open pieces follow your account: a piece pinned on your laptop is pinned on your phone. When two devices disagree, the most recent arrangement wins as a whole rather than being mixed together.

If the incoming list would close a piece you have unsaved work in on this device, that piece is kept, and pinned, and a message says so.

Organizing your work

Organize the desk with tags, folders, and series, star any piece as a favorite for quick access, and keep version history.

Columns and boxes

Open Layout in the formatting bar, or type /columns or /box.

Columns

  1. Select the paragraphs, or put the cursor on an empty line.
  2. Open Layout and choose Two or Three. The text flows down one column, then into the next.
  3. To go back to full width, choose One.

With the cursor in columns, Layout also sets the Gap and a Rule between columns.

Side by side sets two separate columns that each keep their own text. It is a table with its lines switched off; turn the lines on from the table controls.

Boxes

  1. Select the paragraphs, or put the cursor where the box goes.
  2. Select Box in the formatting bar, or choose Box under Layout.
  3. Click the box and select Style.

Style sets:

  • Fill: a color, a picture, or none. A picture has Darken; click the picture to choose the part that stays in view.
  • Text: Light, Dark, or Set for me.
  • Shape: clipped corners, rounded, square, or a bar down the side.
  • Width: This column, Across the columns, or Part of the width. Part of the width has a Share, a Position, and Text beside it.
  • Height: Fits the text or Set height.
  • Border: None, Thin, or Thick.

Drag the handles on the box’s right edge and bottom edge to change its width and height.

Save this look keeps a box’s fill, text, shape and border under a name in Saved styles, for any box.

Above a selected box, Remove box, keep text takes the box away and leaves its text, and Delete box removes both.

A whole chapter in columns

In Imprint, open a chapter’s settings and choose Columns: Two or Three. The chapter’s title stays full width.

On other screens and in exports

  • On a narrow screen, columns fold to one column in reading order, and a box goes full width.
  • The published page, an EPUB, and the print-ready PDF keep columns and boxes.
  • A Word file keeps columns, and a box is a shaded table.
  • The per-piece PDF keeps the words and paragraphs, without the layout.

Page and paragraph layout

Paper and margins

Open Page & view and then Page.

  • Paper and Orientation.
  • Margins, then the top, bottom, left and right margins on their own.
  • Keep single lines from being left alone at the top or bottom of a page.

Print, PDF, Word and the page lines in the editor use these settings.

One paragraph’s format

Select Paragraph (¶) in the formatting bar, or right-click a paragraph and choose Paragraph. A selection of several paragraphs changes them all.

  • Indents: left, right and first line.
  • Spacing: space before and after, and Line spacing. Use the piece’s spacing clears them.
  • Borders and shading: a Border around, above, below or beside the paragraph, its width and color, and Add a fill.
  • Page flow: Keep with next paragraph, Keep lines together and Start on a new page.
  • Tab stops: a Position, an Alignment (left, center, right or decimal) and a Leader, then Add stop.

Tab stops also sit on the ruler. The button at the left end of the ruler sets the kind of stop. Click the ruler to add one, drag it to move it, and drag it off the ruler to remove it. Press Tab inside a line to move to the next stop.

Letter spacing

Open Font in the formatting bar and choose Letter spacing, from condensed to wide.

Open Layout and choose Header and footer.

  1. Type in the left, center or right place of the header or the footer.
  2. Use Insert to add a page number, page count, title, pen name or date where you are typing. Manuscript header: pen name, title, page fills the header in one step.
  3. Set Different first page, Start at and Number style.

Headers and footers show on the page lines in the editor, in print, and in PDF and Word exports.

Section breaks

Open Layout and choose Section break, new page or Section break, same page. Select the label on the break to open Section settings: Starts, Paper and Orientation. Everything after the break uses those settings until the next one.

Tables

With the cursor in a table, open Cell margins and column width in the formatting bar to set the Cell margins and the Width of the column the cursor is in.

Pictures

Select a picture and open Text wrap: Top and bottom, Square, Behind text or In front. A picture behind or in front of the text has a grip for moving it sideways.

On a phone or a tablet

The same settings are in the editor: Paragraph and Text wrap in the formatting bar or under More formatting, letter spacing with the typeface and size, Header and footer and section breaks under Layout, and paper and margins under Page & view.

Still stuck? Head back to Support to report a bug or reach the team.