Skip to content

Import

Import turns an existing draft into a structured book — chapters and scenes detected, shown to you for review, then created. If you arrive with a 50,000-word manuscript, you should be writing in structure within minutes, not splitting it by hand.

Supported sources

Source Description
DOCX Microsoft Word document
TXT Plain text file
Markdown (.md) Text in Markdown format
Scrivener (.scriv) A Scrivener project

How to import

You can start an import in two places:

  • From the welcome screen — choose "Start from an existing manuscript."
  • Inside an open project — run the import command from the command palette or the File menu.

Then:

  1. Pick the file to import.
  2. Review the preview — the detected title, chapters with scene counts, total words, and any warnings from reading the file.
  3. Choose where it lands — a new project, or an existing one. (Inside a project, the current project is preselected; you can change it.)
  4. Click Import.
  5. Review the results — created acts, chapters, scenes, and total words, plus anything skipped, grouped by act, chapter, or scene, with reasons. Click Open Book to land on the first scene, or Close to leave it for later.

Structure detection

Writer Studio reads your headings to find structure, and it understands Russian:

  • Headings like «Глава…» and «Часть…», roman numerals, and Markdown or Word headings become chapters. Only Scrivener's opt-in "Map Part folders to acts" toggle (see below) creates separate part or act containers — everywhere else, a detected part heading survives only as a chapter title.
  • In a Word file, both Heading 1 and Heading 2 become chapters — Heading 1's text becomes that chapter's title, not a separate part. A file that uses a single heading level maps that level to chapters.
  • Within a chapter, a ***, * * *, or --- line, a page break, or (in Markdown files) a level-3 heading (###) starts a new scene.
  • If no structure is found, the whole manuscript becomes one scene. The preview says so plainly.

Scrivener Part folders

By default, a Scrivener Part folder flattens into chapters — the same behavior as before. If you'd rather keep that top level, turn on Map Part folders to acts in the preview: each top-level Part becomes an act, and the folders inside it become chapters under that act. A Part with loose text sitting directly inside it gets that text as the act's first chapter, titled after the Part. A top-level folder that holds only text documents stays a regular chapter and never becomes an act. The toggle is off unless you ask for it, and the preview shows the act hierarchy before anything is created. Empty Parts are skipped, and Part folders nested deeper than the top level still flatten into chapters.

Preview before anything is created

Nothing is created until you confirm. The preview shows the editable book title, the chapters and their scene counts, the total word count, and any warnings from reading the file. The full report of anything skipped — grouped by act, chapter, or scene, with reasons — appears on the results screen after the import completes. You commit only to a structure you have seen.

Encoding

Text files are read as UTF-8. A legacy Russian file (windows-1251 / CP1251) is detected and converted automatically — your Cyrillic comes in correctly, never as garbled characters. An encoding Writer Studio cannot read is rejected with a clear message instead of importing nonsense.

What import promises

  • The source file is untouched. Import reads it; it never changes the original on your disk.
  • Ordinary, editable structure. Every imported chapter and scene can be renamed, moved, or deleted just like structure you made by hand.
  • Nothing half-done. Cancel at any point, or quit the app mid-import, and no partial book is left behind.
  • No phantom word count. Imported words do not count toward your daily goal or streak — they are existing work, not today's writing. See Writing goals.
  • A one-time door. Import does not stay linked to the source file; after the door closes, your project is the source of truth.
  • Export — take a manuscript back out of Writer Studio
  • Structure — work with parts, chapters, and scenes after import
  • Projects — choose or create the project your import lands in