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

# Write and edit pages

> How to edit a page in Flexxible KB: blocks, formatting, images, files, simultaneous editing and help from Teammate.

The Flexxible KB editor works on the page itself: there's no separate editing screen, nothing to save and nothing to publish. Several people and agents can write on the same page at the same time.

## Edit a page

1. Open the page and select **Edit**, or press `E`.
2. Write. The header shows **editing** and the status: *saving* or *saved*.
3. Select **Done**, or press `Esc`, to go back to reading.

Every change is saved instantly and kept in the [History](https://docs.flexxible.com/en/features/flexxible-kb/history.md). Others see it as you type.

> [!NOTE]
>
> If you lose the connection, your changes stay in that tab until you get it back. Keep the tab open so you don't lose them.

## Write at the same time as others

When another person or an agent edits the same page:

* You see their cursor, with their name and color, and their text appears as they type it.
* Below the title it shows who is writing with you, and their avatars appear in the header.
* If you select someone's avatar, the page follows their position. Select it again to stop following them.

An agent's changes are shown just like a person's, with its name.

## Insert blocks

Type `/` on a line to open the block menu and keep typing to filter it.

![A page in editing mode with the block menu open after typing a slash.](https://mintcdn.com/flexxible/luynIZmFTttZPpU9/images/features/kb-editor-slash-menu.png?fit=max\&auto=format\&n=luynIZmFTttZPpU9\&q=85\&s=47c581edccc27ad3fed601de4380c2cd)

| Group | Blocks |
| - | - |
| **Ask Teammate** | **Ask Teammate to write…** and **Write the next section**. |
| **Basic blocks** | **Text**, **Heading 1** to **Heading 4**, **Quote**, **Callout** and **Divider**. |
| **Lists** | **Bulleted list**, **Numbered list** and **Task list**. |
| **Advanced** | **Code block**, **Table** and **Collapsible section**. |
| **Insert** | **Image**, **File**, **Link to a page**, **Diagram**, **Password or key from the vault**, **Today's date** and **Emoji**. |

### Markdown as you type

If you know Markdown, you can type it directly. The editor converts it instantly:

| Type | You get |
| - | - |
| `#`, `##`, `###` or `####` and a space | A heading of the corresponding level. |
| `-` or `*` and a space | A bulleted list. |
| `1.` and a space | A numbered list. |
| `[]` | A task list. |
| `>` and a space | A quote. |
| Three backticks and a space | A code block. |
| `---` | A divider. |

You can also paste Markdown: the editor interprets it as formatted content.

## Format text

When you select text, a bar appears with the options **Ask Teammate**, **Turn into**, **Bold**, **Italic**, **Strikethrough**, **Inline code**, **Link** and **Comment**.

| Format | Windows and Linux | Mac |
| - | - | - |
| Bold | `Ctrl` + `B` | `⌘` + `B` |
| Italic | `Ctrl` + `I` | `⌘` + `I` |
| Strikethrough | `Ctrl` + `Shift` + `X` | `⌘` + `⇧` + `X` |
| Inline code | `Ctrl` + `E` | `⌘` + `E` |
| Link | `Ctrl` + `K` | `⌘` + `K` |
| Heading 1 to 4 | `Ctrl` + `Alt` + `1` to `4` | `⌘` + `⌥` + `1` to `4` |
| Task, bulleted or numbered list | `Ctrl` + `Shift` + `7`, `8` or `9` | `⌘` + `⇧` + `7`, `8` or `9` |
| Comment | `Ctrl` + `Alt` + `M` | `⌘` + `⌥` + `M` |
| Ask Teammate | `Ctrl` + `J` | `⌘` + `J` |

## Callouts

A **Callout** makes a note or warning stand out. There are five types, and you can change the type from the block itself:

| Type | When to use it |
| - | - |
| **Note** | Something worth knowing. |
| **Tip** | A better way to do it. |
| **Important** | What nobody should overlook. |
| **Warning** | Something that can go wrong. |
| **Caution** | Something that can break things or cause data loss. |

## Links to other pages

To link to another page in the knowledge base:

* Type `@` and the page name.
* Or choose **Link to a page** in the `/` menu.
* Or select some text, press `Ctrl` + `K` and search for the page.

The link follows the page even if it's renamed or moved. With `@` you can also insert dates, such as **Today** or **Tomorrow**.

## Images

Paste an image or a screenshot, drag it onto the page or choose **Image** in the `/` menu. PNG, JPEG, GIF and WebP images up to 10 MB are supported.

## Attachments

Choose **File** in the `/` menu, or drag the file onto the page, to attach a vendor manual, a configuration or a log. The file appears as a row with its name and size: a PDF opens in the browser and other types are downloaded.

| Aspect | Detail |
| - | - |
| Can be attached | PDF, Word (`.docx`), Excel (`.xlsx`), PowerPoint (`.pptx`) and text files (`.txt`, `.md`, `.csv`, `.log`, `.json`, `.yaml`, `.xml`). |
| Can't be attached | Files with macros, legacy Office formats, compressed files, programs or scripts, web pages, SVG, audio or video. |
| Limits | The maximum size per file and the total storage are set by Flexxible for your organization. You can check them in **Settings** → **Files**. |

Agents see an attachment's name and size, not its content. Whatever they need to know, write it in the page.

## Tables and code

* **Tables.** Inside a table, `Tab` moves to the next cell. The table menu lets you insert and delete rows and columns, align a column or delete the table.
* **Code blocks.** Choose the **Language** in the block itself to highlight the syntax. In reading mode, each block has a **Copy code** button.
* **Collapsible sections.** Their content stays hidden until someone opens them. They're useful for details not everyone needs.

## Credentials and secrets

Choose **Password or key from the vault** in the `/` menu to link a credential from the [Vault](https://docs.flexxible.com/en/features/flexxible-kb/vault.md). The page stores only a reference: it shows the credential's name, and people copy or reveal its value from there.

If you paste or type something that looks like a password, a token or a key, the editor asks what to do:

* **Save it in the vault.** Creates the credential and leaves a reference in the page.
* **Leave it as text.** Keeps it in the page, at your own responsibility.
* **Leave it out.** Doesn't add it.

## Ask Teammate for help

Inside the editor, Teammate writes or rewrites based on your organization's pages:

* **With no selection**, press `Ctrl` + `J` (`⌘` + `J` on Mac) or choose **Ask Teammate to write…** in the `/` menu, and tell it what to write at that point. **Write the next section** continues the page.
* **With text selected**, choose **Ask Teammate** in the formatting bar and tell it what to do with it, or use one of the quick options: **Rewrite**, **Shorter** or **Turn into steps**.

The text appears in the page as Teammate writes it. When it finishes, you can **Undo** the change. `Esc` stops it.

> [!WARNING]
>
> Teammate is an AI feature: it can make mistakes. Review what it writes before accepting it.

## Next steps

* [Changes and history](https://docs.flexxible.com/en/features/flexxible-kb/history.md)
* [Comments](https://docs.flexxible.com/en/features/flexxible-kb/comments.md)
* [Diagrams](https://docs.flexxible.com/en/features/flexxible-kb/diagrams.md)
