# Importing Your Work

> Bring in Word (with comments, footnotes and tracked changes), RTF, Markdown, OPML, text, Scrivener projects, Fountain and Final Draft scripts, Obsidian vaults, PDFs, images, web pages and Notion exports.

Source: https://writermorph.com/help/importing/

You can bring existing writing and research into WriterMorph in several ways. Importing never changes your original files.

## Word, OpenDocument and RTF into the book

This is the way to bring a whole manuscript in: your parts become folders and your chapters become documents in the binder, ready for the Corkboard, the Outliner and Compile.

1. Open your book in Manuscript Mode: click **Manuscript view** in the planner toolbar, or press ⌃⌘M (Control, Command and M together). A Manuscript tab works too. Anywhere else, WriterMorph answers "Open the Manuscript view first".

   ![The planner toolbar with the pointer on the Manuscript view button.](https://writermorph.com/media/import-1-manuscript-view.webp)

2. Choose **File › Import Files › Word, OpenDocument or RTF into the Book…**. The **File** menu is in the menu bar at the very top of the screen, not inside the window; in full screen, move the pointer to the top edge to show it.

   ![The File menu open at Import Files, with Word, OpenDocument or RTF into the Book highlighted. Word Document as a Tab, at the top of the same list, does something else: it opens the file as a page of its own.](https://writermorph.com/media/import-2-file-menu.webp)

3. Select one or more `.docx`, `.doc`, `.odt`, `.rtf` or `.rtfd` files and click **Open**.
4. WriterMorph asks how to bring them in:
   - **Split at Headings**: large headings become folders and smaller headings become documents. Text before the first heading becomes a document of its own.
   - **One Document per File**: each file becomes one long document. Use this when the file has no headings, or when you want to divide it yourself.

   ![The import question: Split at Headings, One Document per File or Cancel.](https://writermorph.com/media/import-3-split-question.webp)

5. With **Split at Headings**, the book appears in the binder in a folder named after the file. Click a chapter to read and write it.

   ![After Split at Headings: Part One and Part Two are folders, and each chapter is a document inside them.](https://writermorph.com/media/import-4-binder.webp)

   ![A chapter open in the editor, with its place in the book shown above the text.](https://writermorph.com/media/import-5-chapter.webp)

Select a part and choose **Corkboard** to see one index card per chapter, or select the book's folder and choose **Outliner** to see the whole book with word counts.

![The Corkboard for Part One: one card per chapter, with the opening lines as a preview.](https://writermorph.com/media/import-6-corkboard.webp)

![The Outliner: every part and chapter of the imported book in order.](https://writermorph.com/media/import-7-outliner.webp)

### How WriterMorph finds your headings

- **Word heading styles come first.** If the file uses Word's Heading 1, Heading 2 and Heading 3 styles, the highest level in the file becomes folders and the lower levels become documents. In Word, choose the paragraph and pick a heading style in the Home tab's **Styles**.
- **Without heading styles**, WriterMorph looks at the text itself: a short line (up to 140 characters) set noticeably larger than the body text, or a line that is entirely bold, counts as a heading. The largest size becomes folders, the smaller sizes documents.
- A file with one heading level (chapters only) gives a list of chapter documents with no part folders.
- If WriterMorph finds no headings at all, the file comes in as one document, the same as **One Document per File**.

### When the split isn't the way you want it

You can change the result in the binder at any time:

- **Documents › Split › Split at Selection** (⌥⌘K): put the cursor where a new document should start. The text after the cursor becomes a new document just below.
- **Documents › Split › Split with Selection as Title** (⌥⇧⌘K): select the heading line, such as "Chapter 7". The new document starts there and takes the selected text as its title.
- **Documents › Merge** (⇧⌘M): select two or more documents in the binder to join them into one.
- Drag rows in the binder to change the order, or to move a chapter into another part.

![The Documents menu open at Split: Split at Selection and Split with Selection as Title.](https://writermorph.com/media/import-8-split-menu.webp)

If you chose **One Document per File**, split the long document this way at each chapter heading.

### The file opened as a page instead of in the binder?

**File › Import Files › Word Document as a Tab…** and **New ▾ › Word file…** open a Word file as a tab of its own, with its pictures, fonts and page size (see below). A tab is not split into chapters. To work on the file as a book, import it again with **Word, OpenDocument or RTF into the Book…** while Manuscript Mode is open.

### Comments, footnotes and tracked changes in Word files

From a `.docx` file, Word comments come in as WriterMorph comments, and footnotes and endnotes as footnotes. If the document has tracked changes, WriterMorph asks once for the whole import:

- **Accept All Changes**: the text as it would be with every change accepted.
- **Reject All Changes**: the text as it was before the changes.
- **Keep as Revision Marks**: insertions appear in the First Revision color and deletions are struck through. Review them one by one with **Format › Revision Mode › Accept Revision Marks in Selection** or **Reject Revision Marks in Selection**. See [Revisions, History and Snapshots](https://writermorph.com/help/revisions-and-snapshots/).

### A Word file as its own tab

You can also open a Word file as a tab of its own instead of adding it to the book. Choose **File › Import Files › Word Document as a Tab…**, or **New ▾ › Word file…** in the sidebar. A `.docx`, `.doc` or `.odt` file opens as a Document tab with its pictures, fonts and page size.

## Scrivener projects

With Manuscript Mode open, choose **File › Import Files › Scrivener Project (.scriv)…**. WriterMorph reads the Draft folder (folders, texts, synopses and notes) and the Research folder, and adds them to the book in a new folder named after the project.

- PDFs, images, media files and web archives come in as research items.
- Documents that were left out of compile in Scrivener stay left out.
- The Scrivener trash is not imported.

Scrivener's hidden style codes don't show up in the imported text: headings become headings, inline footnotes become footnotes, and inline annotations become comments.

## Import and Split

**File › Import Files › Import and Split…** turns one long file into many documents. Choose a text, Markdown, Word, OpenDocument or RTF file, then:

1. Enter the **Separator**: the text that marks where a new document starts (`#` by default). The file is split wherever the separator stands alone on a line.
2. Choose whether to **Use the first line of each part as the document title**.
3. Click **Import**. Each part becomes a document in a new folder.

## Markdown and OPML into the book

- **File › Import Files › Markdown into the Book…** adds Markdown files as documents of the book (not as tabs). Choose **Split at Headings** (`#` headings become folders and `##` headings documents) or **One Document per File**.
- **File › Import Files › OPML Outline into the Book…** brings in an outline from an outliner or mind-mapping app. Items with children become folders, and each item's note becomes the document's text.

## Screenplays: Fountain and Final Draft

**File › Import Files › Fountain or Final Draft Screenplay…** adds a `.fountain` or `.fdx` screenplay to the book, in a folder named after the file. You can split it into one document per scene or keep it as one document. Scene headings, action, characters, dialogue and the other elements are kept, ready for [Script Mode](https://writermorph.com/help/the-editor/#script-mode).

## Text, Markdown, HTML and RTF files as tabs

**File › Import Files › Text, Markdown, HTML or RTF Files…** adds each file to the project as a tab: Markdown files open as Markdown tabs, HTML files as HTML page tabs, and text and RTF files as notes.

The sidebar's **New ▾** menu has the same choices under **Add from a file on your Mac**: **Markdown file…**, **HTML file…** and **Text or RTF file…**. The file is copied into the project; the original is not changed.

You can choose which plain-text file extensions are accepted in **Settings › Sharing › Import**.

## Research files, web pages, PDFs and images

- **File › Import Files › Research Files into the Binder…**: PDFs, images, audio, videos and documents for reference.
- **File › Import Files › Web Page into the Binder…**: a web page as a research item. Choose **Save a copy for offline reading (web archive)** to keep the page and its images inside the project, or **Keep as a live link** to load it from the internet each time.
- **File › Import Files › PDF…**: a PDF as its own tab.
- **File › Import Files › Images…**: images as tabs.

Research items stay outside the manuscript and are never compiled.

You can also drag files from the Finder straight into the binder. Text, Markdown, Word, OpenDocument and RTF files become documents; PDFs, images, video, audio, web archives and other files become research items.

## Obsidian vaults

WriterMorph reads Obsidian vaults, including their YAML frontmatter.

1. Choose **File › Import › Obsidian Vault…**.
2. Select the vault folder. A progress window and a report show what was imported.

The vault becomes a new project with one planner. WriterMorph maps notes to cards:

| In Obsidian | In WriterMorph |
|---|---|
| `Class: Scene` or `Chapter` notes | Scene cards in the manuscript, in number order |
| `Act` | Act folders (Act I, Act II, Act III) |
| `Synopsis` / `Summary` | The card's synopsis and notes |
| `When`, `End`, `Duration` | Story time on the Writer Timeline |
| `POV`, `Character` | Point of view and cast |
| `Subplot` | Plotlines |
| `Place`, `Location`, `Setting` | Places |
| `Status`, `Tension`, `Beat`, `Target`, `tags` | The matching card fields |
| `Class: Character` and `Class: Place` notes | Character and location profile cards |
| Any other key | A typed card property (number, date, checkbox, list, link and so on) |
| Images and PDFs | Copied into the project and attached or shown as tabs |

Wikilinks with aliases keep their alias text, embedded images are copied in, and Obsidian comments are removed. Your vault itself is never modified.

### Updating from a vault

Keep working in Obsidian? **File › Import › Obsidian Vault into Current Planner (Update by ID)…** updates cards in place instead of duplicating them, keeps their positions on the canvas, and adds new notes. WriterMorph takes a revert point first, so you can undo the update.

### Exporting back to Obsidian

**File › Export › Obsidian Vault…** writes every card as a Markdown file with frontmatter, in folders that mirror your binder. Importing that export again gives you the same cards, fields and connections.

### Databases and Obsidian

Cards of your own card types, and of built-in types you have set up as [databases](https://writermorph.com/help/databases/), are exported with a `collection:` line that names their database, for example `collection: Weapons`. Obsidian plugins that read frontmatter, such as Dataview, can then list them by database. On import, a note with a `collection:` line becomes a card of that database. If the planner has no database with that name, WriterMorph creates it.

## Notion exports

WriterMorph imports Notion's **Markdown & CSV** export.

1. In Notion, export your pages as **Markdown & CSV**.
2. In WriterMorph, choose **File › Import › Notion Export (Markdown & CSV)…**. It is also under **File › Import Files**.
3. Choose the export's folder, its `.zip` file, or any of its `.md` and `.csv` files. ⌘-click to choose several.

Everything you choose becomes one new project; the export itself is not changed. A progress window and a report show what was imported and any links that could not be matched.

| In Notion | In WriterMorph |
|---|---|
| A database | A database: a card type with its fields |
| A database row | A card |
| A column | A field, with a matching type such as number, checkbox, date, URL, email, select, multi-select, files or relation |
| The text of a page | The card's text |
| A page outside a database | A text card under its parent page |
| Images | Copied into the project and shown in the text |
| Other files | Card attachments |
| Relations | Links between cards, matched by title |

To see the imported databases as tables, galleries, boards and calendars, turn on **Settings › Labs › Databases**. The import itself works without it.

## Other imports

- **File › Import › Planner JSON…**: a WriterMorph planner exported as JSON.
- **File › Import › Book (.wmorph)…**: a manuscript package from another project.
