> ## Documentation Index
> Fetch the complete documentation index at: https://docs.inkwell.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Zoom Controls

> Adjust zoom level to find the perfect text size for comfortable writing.

Inkwell offers flexible zoom controls to match your screen size, vision preferences, and writing style.

## Zoom Shortcuts

| Action            | macOS   | Windows  |
| ----------------- | ------- | -------- |
| Zoom In           | `Cmd+=` | `Ctrl+=` |
| Zoom Out          | `Cmd+-` | `Ctrl+-` |
| Reset Zoom (100%) | `Cmd+0` | `Ctrl+0` |
| Zoom to Fit       | `Cmd+9` | `Ctrl+9` |

<Tip>
  **Zoom to Fit** (`Cmd/Ctrl+9`) automatically sets the perfect zoom level to show a full page width. Try it first!
</Tip>

## Zoom to Fit (Recommended)

**What it does**:

* Calculates optimal zoom to show a full page width
* Accounts for your window size
* Maintains proper screenplay formatting
* Adjusts automatically when you resize the window

**How to use**:

1. Press `Cmd/Ctrl+9`
2. Page width matches window width
3. Resize window → zoom adjusts automatically

**Best for**:

* First time using Inkwell
* After connecting/disconnecting external monitors
* When you want to see the full page at once
* Working on different screen sizes

<Note>
  Zoom to Fit is a toggle. Press `Cmd+9` again to disable auto-fitting and return to manual zoom control.
</Note>

## Manual Zoom

### Zoom In (`Cmd+=`)

**Increases** text size by \~10% per press

**Use when**:

* Text feels too small
* Eyestrain from small fonts
* Presenting or screen sharing
* Working on high-resolution displays

### Zoom Out (`Cmd+-`)

**Decreases** text size by \~10% per press

**Use when**:

* Want to see more text at once
* Reviewing full page layouts
* Editing long scenes
* Working on smaller screens

### Reset Zoom (`Cmd+0`)

**Returns** to 100% (default size)

**Use when**:

* Zoomed too far in/out
* Want to return to standard size
* Sharing your screen with others

## Find Your Perfect Zoom

### For Writing

**125-150% zoom**:

* Larger text reduces eye strain
* Easier to focus on current line
* Good for long writing sessions
* Press `Cmd+=` 2-4 times from default

### For Editing

**100-110% zoom** (or Zoom to Fit):

* See more context at once
* Easier to track scene flow
* Standard screenplay appearance
* Good for revisions

### For Outlining

**75-90% zoom**:

* See multiple scenes at once
* Better bird's-eye view
* Easier to track structure
* Press `Cmd+-` 1-3 times from default

### For Presentations

**150-200% zoom**:

* Audience can read easily
* Good for screen sharing
* Clear on projectors
* Press `Cmd+=` 4-7 times from default

## Zoom Persistence

**Your zoom level is saved**:

* Per script (each `.ink` file remembers its zoom)
* Persists across sessions
* Applies when you reopen the file

**Exception**: Zoom to Fit recalculates based on current window size, so it may differ if you change monitors or window size.

## Common Zoom Scenarios

### Laptop + External Monitor

**Problem**: Zoom looks wrong when switching displays\
**Solution**: Press `Cmd+9` (Zoom to Fit) after connecting/disconnecting monitor

### Reading on Small Screens

**Problem**: Text too small on 13" laptops\
**Solution**: Zoom In to 125-150% or use Zoom to Fit

### Comparing Scenes

**Problem**: Need to see multiple scenes at once\
**Solution**: Zoom Out to 75-90% to fit more on screen

### Sharing Screen

**Problem**: Audience can't read text\
**Solution**: Zoom In to 150-200%

## Combine with Other Features

**Focused Writing**: Zoom to Fit + Focus Mode

```
1. Press Cmd+9 (Zoom to Fit)
2. Press Cmd+Shift+D (hide drawer)
```

Result: Full page width, no distractions.

**Comfortable Long Sessions**: 125% Zoom + Sepia Theme

```
1. Press Cmd+= two times (125% zoom)
2. File → Settings → Sepia theme
```

Result: Larger, warmer text for extended writing.

**Overview Mode**: Zoom Out + Navigation Panel

```
1. Press Cmd+- two times (zoom out)
2. Press Cmd+J (show Project Panel → Navigation)
```

Result: See scene structure and navigation together.

## Common Questions

<AccordionGroup>
  <Accordion title="Does zoom affect printing?">
    No. Zoom only affects editor display. Your script prints at standard size regardless of zoom level.
  </Accordion>

  <Accordion title="What's the zoom range?">
    Approximately 50% to 300%. Inkwell prevents zooming beyond usable limits.
  </Accordion>

  <Accordion title="Why does my zoom reset when I reopen Inkwell?">
    Your zoom level should persist. If it doesn't, make sure you're saving the file (`Cmd+S`) before closing. Unsaved files may not remember zoom settings.
  </Accordion>

  <Accordion title="Can I set a default zoom for all new scripts?">
    Not currently. Each script remembers its own zoom level. Use Zoom to Fit (`Cmd+9`) as a quick way to optimize any script.
  </Accordion>

  <Accordion title="Does Zoom to Fit work with Focus Mode?">
    Yes! Zoom to Fit recalculates based on available space. With Focus Mode (drawer hidden), you get more horizontal space, so Zoom to Fit adjusts accordingly.
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Focus Mode" icon="eye-slash" href="/customization/focus-mode">
    Hide the Project Panel for more writing space
  </Card>

  <Card title="Typewriter Mode" icon="keyboard" href="/customization/typewriter-mode">
    Keep cursor centered while typing
  </Card>

  <Card title="Themes" icon="palette" href="/customization/themes">
    Choose a theme for comfortable viewing
  </Card>

  <Card title="Keyboard Shortcuts" icon="keyboard" href="/reference/keyboard-shortcuts">
    Learn all Inkwell shortcuts
  </Card>
</CardGroup>