Importing an outline
Updated
An outline is the structure of a book without its text: chapters, each with its scenes. The same Import… wizard (File > Import… for a new book, File > Import into This Book… to add to the open one) reads three kinds of outline file:
- OPML (
.opml), which most outliners can export (OmniOutliner, Bike, Workflowy, Dynalist and others). The top-level rows become chapters and their children scenes; a row's note becomes the scene's synopsis. An OPML file written by CadabraCraft also carries point of view, status, label, target and story date, and these are kept. Rows nested deeper than a scene are left out, and the report says how many. - CSV (
.csv) from a spreadsheet. The first row names the columns:chapterandtitle(orscene) are the ones that matter, andsynopsis(orsummary),pov,status,label,target_words,dateandcastare used when present, in any order, with commas, semicolons or tabs between cells. Rows with the same chapter name in a row form one chapter. A row that names a chapter and no scene adds a chapter with no scenes. Without achaptercolumn the scenes go into one chapter called Untitled. - Markdown (
.md): a#heading starts a chapter, a##heading a scene, and the text below it is the synopsis. A Markdown file is read as a manuscript unless you choose Outline under Read this file as in the preview step.
The preview shows each chapter with its number of scenes. As for a manuscript you can rename, skip, reorder and merge chapters before anything is written. Each chapter is added with its scenes (title, synopsis and, where the file has them, point of view, status, label, target and story date), each with an empty paragraph to write in. A status that is not Outline, Draft, Revised or Final, a date that is not YYYY-MM-DD, or a text that is too long is cleaned and listed in the Import report. The cast is not imported (add characters to the codex and choose them in the scene), and the report says so.
Nothing in the book is overwritten: chapters are added after the last one, every scene gets a new id (so importing the same file twice adds a second copy instead of replacing the first), and your original file is never changed. A file that is damaged, not an outline, empty, too large (5 MB) or with more than 1,000 chapters or 20,000 scenes is refused with a message and nothing is written.