# Write the first chapter

Source: https://docs.novelos.studio/tutorials/first-chapter/ (updated 2026-11-09). Part of the NovelOS Studio 1.5.1 docs.

**Before you start:** finish [Outline in Blueprint](https://docs.novelos.studio/tutorials/outline.md).

Time for actual words. This tutorial writes the opening of chapter one, and along the way shows the tools that keep you writing instead of fiddling.

## Add the chapter

1. Press `⌘5` for the **Manuscript**. The **Table of Contents** on the left says **No chapters yet.**
2. Click **New Chapter**. A chapter called **Chapter** appears and opens.
3. Double-click its name in the Table of Contents, type `Judging Day`, and press `Enter`.
4. In the editor, hover the title, click **Add Subtitle** under it and type `Saturday, nine o'clock` into **Enter subtitle...**.

## Write, and mention people

1. Click into the page (it says **Begin your story...**) and start the chapter:

   `Nobody in Little Wickham had died of marmalade before, and Mabel Thorne intended to keep it that way.`

2. Start the next sentence and type `@Lio`. A list of @mentions opens with **Lionel Fairweather** under **Cast**. Press `Enter`.
3. Mention `@Iris` and `@Mabel` the same way somewhere in the next few lines.
4. Hover one of the mentions.

You should now see a small card with the character's name and **Click to view details**. Clicking it opens their page in Cast & World.

5. Click **Scene Break** in the toolbar to start the second half of the chapter, after the collapse.

![The card that appears when you point at a mention: the entry's picture, name and type, and Click to view details.](https://docs.novelos.studio/assets/screens/mention-card.webp)
_Shown with the demo book, The Constellation's End._

## Try the focus modes

**Vanishing Mode** is for the bit of a first draft where you keep rewriting the same sentence.

1. Click **Enable Vanishing Mode** in the toolbar.
2. Write a paragraph. Backspace does nothing and the lines above fade away. You can only go forward.
3. Click **Disable Vanishing Mode** when the paragraph is down.

**Zen Mode** hides everything but the page. Press `⇧⌘F` to go in, and `Esc` to come out.

Glance at the status bar along the bottom. **Word Count** shows this chapter's words, and Overview's **Today** count is now above zero.

## Leave yourself a note

1. Select the words `died of marmalade` in your first sentence.
2. Click **Comment on Selection**, type `Poisoned spoon or poisoned jar? Decide before chapter 3.` and press `Enter`.
3. Press `⇧⌘M`.

You should now see **Margin Notes** with your comment in it. Click it to jump back to the passage. Once you have decided about the spoon, tick the note done.

![Margin Notes: every comment and bookmark in the book, with chapter filters and Open and Done tabs.](https://docs.novelos.studio/assets/screens/margin-notes.webp)
_Shown with the demo book, The Constellation's End._

## Take a snapshot

Before you try a bold rewrite, keep a copy.

1. Press `⇧⌘S`. **Snapshots of Judging Day** opens.
2. Type `First draft of the opening` in **Name this snapshot (optional)** and click **Take snapshot**.
3. Close it, and rewrite the last paragraph however you like.
4. Open **Snapshots** again and click your named snapshot.

You should now see what changed: added words highlighted, removed ones struck through, and a count of each such as "+12 words" and "−5 words". **Restore** would bring the old version back, and NovelOS keeps today's text as a snapshot first, so nothing is lost either way.

## Put the scene in its chapter

1. Press `⌘4` for **Blueprint**, click the **Scenes** tab and open **Judging Day**.
2. Click **Chapter** (it says **Unplaced**) and pick **Judging Day**.
3. Click **Timeline View**.

You should now see the scene in the chapter's own row, no longer under **Outside the book**.

**Optional, with a Muse key:** point at a paragraph and click **Polish Prose (Show Don't Tell)**. **The Alchemist** offers three rewrites, and **Apply** swaps one in. See [The editor](https://docs.novelos.studio/guides/write/editor.md#the-alchemist).

## Learn more

- [Chapters, parts and the Manuscript](https://docs.novelos.studio/guides/write/manuscript.md)
- [The editor, focus modes and the status bar](https://docs.novelos.studio/guides/write/editor.md)
- [Mentions](https://docs.novelos.studio/guides/write/mentions.md)
- [Comments, bookmarks and Margin Notes](https://docs.novelos.studio/guides/write/notes-and-bookmarks.md)
- [Snapshots of a chapter](https://docs.novelos.studio/guides/write/snapshots.md)

**Next:** [Revise: find, mentions, Read Aloud, Book Preview](https://docs.novelos.studio/tutorials/revise.md)
