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

# Edit an AI doc: blocks, tables, find and replace

> Edit an AI doc in Hamsa Media: slash menu, block handle, toolbars, tables, toggles, colours, Markdown paste, text direction, find and replace and autosave.

A finished AI doc opens on a page you can edit like any document. Type `/` to add blocks, drag them to reorder, and format text from the toolbar. The doc saves by itself as you type.

![An AI doc open: the document bar with Header, Footer, Background, the word count and Saved; the toolbar; the outline on the left; the white page with headings and lists](https://mintcdn.com/hamsa-452fa79a/7GY0-8K2sfzXu6G7/images/media/ai-docs/doc-editor-light.webp?fit=max\&auto=format\&n=7GY0-8K2sfzXu6G7\&q=85\&s=31506786c4cf73160628a97b829f673d)

## Before you start

* The doc must be **Completed**. See [Statuses](https://docs.tryhamsa.com/media/ai-docs/create-a-doc.md#statuses).

## Add blocks with the slash menu

Type `/` at the start of a line (an empty line says "Type “/” for blocks"). Keep typing to filter, use the up and down arrows to move, and press Enter or Tab to choose. Escape closes the menu. The filter also matches Arabic words.

| Block | What it is | Type this instead |
| - | - | - |
| **Text** | Plain writing | |
| **Heading 1** | A big section heading | `#` and a space |
| **Heading 2** | A medium heading | `##` |
| **Heading 3** | A small heading | `###` |
| **Bulleted list** | A simple list | `-` |
| **Numbered list** | A list in order | `1.` |
| **To-do list** | Things to tick off | `[ ]` |
| **Quote** | What someone said | `>` |
| **Toggle list** | Hide and show what's inside | |
| **Callout** | A note that stands out | |
| **Code** | Code, as it was typed | ` ``` ` |
| **Table** | Rows and columns | |
| **Divider** | A line between parts | `---` |

![The slash menu open under a new line, showing Text, Heading 1 to 3, Bulleted list, Numbered list and To-do list with their Markdown hints on the right](https://mintcdn.com/hamsa-452fa79a/fdE-9_eEW1W6yh_s/images/media/ai-docs/slash-menu-light.webp?fit=max\&auto=format\&n=fdE-9_eEW1W6yh_s\&q=85\&s=7434c7133c5b46c4eede869907c65977)

## Move and change blocks

Hover over a block to see its handle in the margin.

* **+** (**Add a block below**) adds an empty line under the block and opens the slash menu.
* Drag the grip to move the block. Click the grip to open its menu.

| Menu item | What it does | Shortcut |
| - | - | - |
| **Turn into** | Makes the block another kind (any block above except table and divider) | |
| **Icon** and **Colour** | For a callout: its emoji and its tone (Grey, Blue, Green, Yellow, Red, Purple) | |
| **Colour** | The block's **Text colour** or **Background**: Grey, Brown, Orange, Yellow, Green, Blue, Purple, Pink, Red, or **Default** | |
| **Duplicate** | Copies the block under itself | Cmd+D (Ctrl+D on Windows) |
| **Move up** / **Move down** | Moves the block one place | Cmd+Shift+Up / Down |
| **Delete** | Removes the block | |

![The block menu open from the grip beside a heading: Turn into, Colour, Duplicate, Move up, Move down and Delete](https://mintcdn.com/hamsa-452fa79a/7GY0-8K2sfzXu6G7/images/media/ai-docs/block-menu-light.webp?fit=max\&auto=format\&n=7GY0-8K2sfzXu6G7\&q=85\&s=52d83455c5beba11c127917104d91bf3)

Block colours work on text, headings, quotes and lists. A new block you start with Enter has no colour. Colours show in the pages preview and the PDF.

## Format text

Select text and a small toolbar appears over it: the block type, **Bold**, **Italic**, **Underline**, **Strikethrough**, **Code**, **Link** and **Colour** (text colour and background).

The toolbar above the page has the rest:

| Control | What it does |
| - | - |
| **Undo**, **Redo** | Cmd+Z, Cmd+Shift+Z (Ctrl on Windows) |
| **Block type** | Turns the block into text, a heading, a list, a quote, a toggle, a callout or code |
| **Size** | 12 to 32 px |
| **Bold**, **Italic**, **Underline**, **Strikethrough** | Cmd+B, Cmd+I, Cmd+U, Cmd+Shift+S |
| **Text color**, **Highlight** | Colour the text or mark it |
| **Bulleted list**, **Numbered list**, **Quote** | Cmd+Shift+8, Cmd+Shift+7, Cmd+Shift+B |
| **Alignment** | **Align left**, **Center**, **Align right**, **Justify** |
| **Left-to-right text**, **Right-to-left text** | The direction of the current paragraph |
| **Link** | Add, change or remove a link |
| **Clear formatting** | Removes styles from the selection |
| **Find and replace** | Cmd+F (Ctrl+F on Windows) |

![The selection toolbar over a selected paragraph with its Colour panel open, showing Text colour and Background swatches](https://mintcdn.com/hamsa-452fa79a/fdE-9_eEW1W6yh_s/images/media/ai-docs/selection-toolbar-colour-light.webp?fit=max\&auto=format\&n=fdE-9_eEW1W6yh_s\&q=85\&s=0613bf863670fd3c2a604af29a3c87b0)

## Text direction

The page follows the document's language: an Arabic doc reads right to left. You can turn a single paragraph the other way, for an English quote in an Arabic doc for example:

* Click **Left-to-right text** or **Right-to-left text** in the toolbar.
* Or press Ctrl with the left Shift for left to right, or Ctrl with the right Shift for right to left, as in Word and Google Docs.

Choosing the document's own direction puts the paragraph back.

## Tables

Choose **Table** in the slash menu to add a 3 by 3 table with a header row. Click in a table and its own toolbar appears:

**Add a row above**, **Add a row below**, **Delete the row**, **Add a column before**, **Add a column after**, **Delete the column**, **Header row on or off**, **Delete the table**.

![A table in a doc with a header row, and its toolbar above it with the row, column, header row and delete buttons](https://mintcdn.com/hamsa-452fa79a/fdE-9_eEW1W6yh_s/images/media/ai-docs/table-toolbar-light.webp?fit=max\&auto=format\&n=fdE-9_eEW1W6yh_s\&q=85\&s=df15c0f84c634b2b7481a48f189aeb88)

## Toggles and callouts

* A **Toggle list** has a title line and hides what's under it. Click its arrow to open or close it. Turning several selected blocks into a toggle makes the first one the title and puts the rest inside.
* A **Callout** is a tinted box with an emoji. Change both from the block menu.

## Paste Markdown

Paste text written in Markdown (from a chat assistant, a `.md` file or a code editor) and it becomes real blocks: headings, lists, to-dos, quotes, code, tables, bold and links. A paste that is already formatted, from a web page for example, keeps its own formatting. A paste into a code block stays as plain code.

## Find and replace

Press Cmd+F (Ctrl+F on Windows) or click **Find and replace**. The bar opens inside the document and highlights every match.

* Type in **Find in document**. The bar shows where you are, for example "2 of 7", or "No matches".
* Press Enter for the next match and Shift+Enter for the previous one.
* **Match case** and **Whole word** narrow the search. **Ignore harakat** is on by default, so a search finds Arabic words with or without their marks.
* Type in **Replace with**, then **Replace** for the current match or **Replace all**. Replace all is one step: one undo puts it all back.
* Escape closes the bar.

![The find and replace bar under the toolbar: voice in Find in document, 2 of 5, Match case, Whole word and Ignore harakat, narrator in Replace with, and the matches highlighted in the doc](https://mintcdn.com/hamsa-452fa79a/fdE-9_eEW1W6yh_s/images/media/ai-docs/find-replace-light.webp?fit=max\&auto=format\&n=fdE-9_eEW1W6yh_s\&q=85\&s=37a27987480e5508a2d385f85fa6996f)

## Outline, word count and reading time

* **Outline** lists the doc's headings (levels 1 to 3). Click one to jump to it. On a wide screen it sits beside the page, and **Hide outline** folds it away; on a smaller screen, open it from **Outline** in the document bar.
* The document bar shows the word count and the reading time ("5 min read", or "Under a minute to read"). Reading time counts English at 200 words a minute and Arabic at 140.

## Saving

The doc saves by itself: a moment after you stop typing, every few seconds while you keep typing, and when you leave the tab or close the page. The document bar shows **Saving…**, then **Saved**. Press Cmd+S (Ctrl+S on Windows) to save at once.

If a save fails, the bar shows **Not saved** and **Retry**. Your changes stay on the page and go with the next save.

## Good to know

* **Copy text** in the document bar copies the whole doc as plain text.
* **Preview pages** shows the doc as it exports, page by page, with its header, footer and background. See [Page design](https://docs.tryhamsa.com/media/ai-docs/page-design.md).
* The page stays white in dark mode, as it prints.
* There is no image block in the editor. To put a picture on the page, use a [background image](https://docs.tryhamsa.com/media/ai-docs/page-design.md#page-background) or a logo in the header.

## Related

> [card] [Page design](https://docs.tryhamsa.com/media/ai-docs/page-design.md)
>
> Page style, background, header and footer.

> [card] [Export a doc](https://docs.tryhamsa.com/media/ai-docs/export.md)
>
> PDF, Word, Markdown, web page and more.


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