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

# Editing with AI

> Select text in a document and have the assistant rewrite it in place

> [!NOTE]
>
> Requires the **Editor** feature to be enabled for your organization. Ask your administrator if you can't see it.

**Ask AI** rewrites a part of your document without leaving the editor. Select a passage, describe the change, and the assistant replaces the text in place. It's the quickest way to shorten a paragraph, fix grammar or change the tone of a section.

![A document in the Editor](https://mintcdn.com/blackmountaingmbh/XFag3CE4nO-WN3UD/images/screens/en/editor/document.png?fit=max\&auto=format\&n=XFag3CE4nO-WN3UD\&q=85\&s=447b245737ef4c344f3ce58a8364af53)

## Rewrite a selection

1. Select the text you want to change. The formatting bar appears.
2. Click **Ask AI**.
3. Describe the change in **Describe the change…**, for example "Turn this into a bulleted list" or "Make it sound friendlier".
4. Press **Enter** or click **Rewrite**.

The rewritten text appears in the document and is briefly highlighted.

## Quick actions

Below the input, one click runs a common rewrite right away:

* **Make it shorter**
* **Expand on this**
* **Fix spelling & grammar**
* **Simplify the language**
* **More professional**

## Apply a skill

If your organization uses [Skills](https://docs.blackmountain.io/editor/skills/introduction.md), you can pick one skill under **Apply a skill**. Its instructions guide the rewrite, for example your brand voice or a writing checklist. Choose **No skill** to rewrite without one.

## What gets rewritten

Ask AI works on whole blocks, such as paragraphs, headings or list items. If your selection starts or ends in the middle of a paragraph, the whole paragraph is rewritten. Select complete paragraphs to keep the result predictable.

The rest of the document is not changed.

## Undo a rewrite

Each rewrite is saved as its own version, marked as made by the **Assistant**. To undo it, open **Version history** and restore the version before it. See [Revisions and restore](https://docs.blackmountain.io/editor/revisions.md).

> [!TIP]
>
> For larger changes across a whole document, such as restructuring or adding new sections, ask the assistant in a chat instead. See [Editor side panel](https://docs.blackmountain.io/editor/side-panel.md).

If your organization uses [PII protection](https://docs.blackmountain.io/chat/pii-protection.md), personal data in the selection is masked before it reaches the AI model and restored in the result.

## Related

> [card] [Editor side panel](https://docs.blackmountain.io/editor/side-panel.md)
>
> Let the assistant edit the whole document from a chat.

> [card] [Revisions and restore](https://docs.blackmountain.io/editor/revisions.md)
>
> Undo any change, including AI rewrites.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.