Import a document into a project

Bringing your own material to Voysey? Drop it onto a project and it comes in. Word documents, PDFs, EPUBs, Markdown, and plain text all import. Each one is parsed for its structure, classified by what it contains, and routed to the right kind of destination. A screenplay lands as a screenplay, a novel manuscript lands as a novel, a treatment lands where a treatment goes.

Formats supported

• .docx: Word documents, with headings preserved as chapter or scene breaks.
• .pdf: text extracted best-effort. Works well for text-first PDFs. Heavily-designed PDFs (columns, footnotes) may need cleanup after import.
• .epub: chapters are read from the book's spine, so structure survives the import.
• .md: Markdown, split into chapters at heading boundaries.
• .txt: plain text. A single chapter unless the file uses obvious dividers.

How to import

1. Open the project you want to import into (or start a new one, since Voysey will figure out the destination either way).
2. Drag the file onto the dock at the bottom of the studio.
3. Voysey picks it up, parses it, and queues classification. The project gets an import pending badge while this runs.
4. When classification finishes, the badge clears and the document lands in place. A manuscript slots into the novel outline, a screenplay slots into the screenplay editor, and so on. No refresh needed. It updates live.

What the classifier decides

Voysey reads the imported document and picks a destination based on what it looks like:

• Prose with chapters becomes a novel.
• Screenplay format (INT./EXT., character cues, dialog) becomes a screenplay.
• Outline, synopsis, or logline becomes a treatment.
• Anything that does not fit a specific pipeline becomes a general document you can reference from chat.

Chapter splitting

Each format is split into chapters using the structure that format provides: an EPUB's spine, a DOCX's heading levels, a Markdown file's hash-headings, or the AST for plain text. Voysey does not need you to hand-mark chapters. It finds them.

If something goes wrong

• Very large files can take a minute or two to parse. The pending badge stays put until it finishes. Nothing is lost.
• If classification stalls, Voysey reclaims the job and retries. You do not have to re-upload.
• Heavily-designed PDFs sometimes need a manual pass after import. If the result looks scrambled, ask Voysey in chat to re-flow the text. It will tidy it up.