> ## 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.

# Escrever e editar páginas

> Como editar uma página no Flexxible KB: blocos, formatação, imagens, arquivos, edição simultânea e ajuda do Teammate.

O editor do Flexxible KB funciona sobre a própria página: não há uma tela de edição separada, nada para salvar e nada para publicar. Várias pessoas e agentes podem escrever na mesma página ao mesmo tempo.

## Editar uma página

1. Abra a página e selecione **Editar**, ou pressione `E`.
2. Escreva. O cabeçalho indica **editando** e o estado: *salvando* ou *salvo*.
3. Selecione **Concluído**, ou pressione `Esc`, para voltar à leitura.

Cada alteração é salva na hora e fica no [Histórico](https://docs.flexxible.com/pt-BR/features/flexxible-kb/history.md). Os demais a veem enquanto você escreve.

> [!NOTE]
>
> Se você perder a conexão, as suas alterações ficam nessa aba até que ela seja recuperada. Mantenha a aba aberta para não perdê-las.

## Escrever ao mesmo tempo que outros

Quando outra pessoa ou um agente edita a mesma página:

* Você vê o cursor dela, com o seu nome e a sua cor, e o texto dela aparece à medida que ela o escreve.
* Abaixo do título é indicado quem está escrevendo com você, e os avatares aparecem no cabeçalho.
* Se você selecionar o avatar de alguém, a página acompanha a posição dessa pessoa. Selecione-o novamente para deixar de segui-la.

As alterações de um agente são exibidas da mesma forma que as de uma pessoa, com o seu nome.

## Inserir blocos

Digite `/` em uma linha para abrir o menu de blocos e continue digitando para filtrá-lo.

![Uma página no modo de edição com o menu de blocos aberto depois de digitar uma barra.](https://mintcdn.com/flexxible/luynIZmFTttZPpU9/images/features/kb-editor-slash-menu.png?fit=max\&auto=format\&n=luynIZmFTttZPpU9\&q=85\&s=47c581edccc27ad3fed601de4380c2cd)

| Grupo | Blocos |
| - | - |
| **Perguntar ao Teammate** | **Pedir ao Teammate que escreva…** e **Escrever a próxima seção**. |
| **Blocos básicos** | **Texto**, **Título 1** a **Título 4**, **Citação**, **Destaque** e **Separador**. |
| **Listas** | **Lista com marcadores**, **Lista numerada** e **Lista de tarefas**. |
| **Avançados** | **Bloco de código**, **Tabela** e **Seção recolhível**. |
| **Inserir** | **Imagem**, **Arquivo**, **Link para uma página**, **Diagrama**, **Senha ou chave do cofre**, **Data de hoje** e **Emoji**. |

### Markdown enquanto você escreve

Se você conhece Markdown, pode escrevê-lo diretamente. O editor o converte na hora:

| Digite | Você obtém |
| - | - |
| `#`, `##`, `###` ou `####` e um espaço | Um título do nível correspondente. |
| `-` ou `*` e um espaço | Uma lista com marcadores. |
| `1.` e um espaço | Uma lista numerada. |
| `[]` | Uma lista de tarefas. |
| `>` e um espaço | Uma citação. |
| Três acentos graves e um espaço | Um bloco de código. |
| `---` | Um separador. |

Você também pode colar Markdown: o editor o interpreta como conteúdo formatado.

## Formatar

Ao selecionar texto, aparece uma barra com as opções **Perguntar ao Teammate**, **Transformar em**, **Negrito**, **Itálico**, **Tachado**, **Código embutido**, **Link** e **Comentar**.

| Formato | Windows e Linux | Mac |
| - | - | - |
| Negrito | `Ctrl` + `B` | `⌘` + `B` |
| Itálico | `Ctrl` + `I` | `⌘` + `I` |
| Tachado | `Ctrl` + `Shift` + `X` | `⌘` + `⇧` + `X` |
| Código embutido | `Ctrl` + `E` | `⌘` + `E` |
| Link | `Ctrl` + `K` | `⌘` + `K` |
| Título 1 a 4 | `Ctrl` + `Alt` + `1` a `4` | `⌘` + `⌥` + `1` a `4` |
| Lista de tarefas, com marcadores ou numerada | `Ctrl` + `Shift` + `7`, `8` ou `9` | `⌘` + `⇧` + `7`, `8` ou `9` |
| Comentar | `Ctrl` + `Alt` + `M` | `⌘` + `⌥` + `M` |
| Perguntar ao Teammate | `Ctrl` + `J` | `⌘` + `J` |

## Destaques

Um **Destaque** faz com que uma nota ou um aviso se sobressaia. Há cinco tipos, e você pode alterar o tipo no próprio bloco:

| Tipo | Quando usá-lo |
| - | - |
| **Nota** | Algo que convém saber. |
| **Dica** | Uma forma melhor de fazer. |
| **Importante** | O que ninguém deve deixar passar. |
| **Aviso** | Algo que pode dar errado. |
| **Cuidado** | Algo que pode quebrar coisas ou causar perda de dados. |

## Links para outras páginas

Para vincular outra página da base de conhecimento:

* Digite `@` e o nome da página.
* Ou escolha **Link para uma página** no menu `/`.
* Ou selecione um texto, pressione `Ctrl` + `K` e busque a página.

O link acompanha a página mesmo que ela seja renomeada ou movida. Com `@` você também pode inserir datas, como **Hoje** ou **Amanhã**.

## Imagens

Cole uma imagem ou uma captura de tela, arraste-a para a página ou escolha **Imagem** no menu `/`. São aceitas imagens PNG, JPEG, GIF e WebP de até 10 MB.

## Anexos

Escolha **Arquivo** no menu `/`, ou arraste o arquivo para a página, para anexar o manual de um fornecedor, uma configuração ou um log. O arquivo aparece como uma linha com o seu nome e o seu tamanho: um PDF é aberto no navegador e os demais tipos são baixados.

| Aspecto | Detalhe |
| - | - |
| Podem ser anexados | PDF, Word (`.docx`), Excel (`.xlsx`), PowerPoint (`.pptx`) e arquivos de texto (`.txt`, `.md`, `.csv`, `.log`, `.json`, `.yaml`, `.xml`). |
| Não podem ser anexados | Arquivos com macros, formatos antigos do Office, arquivos compactados, programas ou scripts, páginas web, SVG, áudio nem vídeo. |
| Limites | O tamanho máximo por arquivo e o espaço total são definidos pela Flexxible para a sua organização. Eles podem ser consultados em **Configurações** → **Arquivos**. |

Os agentes veem o nome e o tamanho de um anexo, não o seu conteúdo. O que eles precisarem saber, escreva na página.

## Tabelas e código

* **Tabelas.** Dentro de uma tabela, `Tab` passa para a célula seguinte. O menu da tabela permite inserir e excluir linhas e colunas, alinhar uma coluna ou excluir a tabela.
* **Blocos de código.** Escolha a **Linguagem** no próprio bloco para colorir a sintaxe. Na leitura, cada bloco tem um botão **Copiar código**.
* **Seções recolhíveis.** O seu conteúdo fica oculto até que alguém as abra. São úteis para detalhes de que nem todo mundo precisa.

## Credenciais e segredos

Escolha **Senha ou chave do cofre** no menu `/` para vincular uma credencial do [Cofre](https://docs.flexxible.com/pt-BR/features/flexxible-kb/vault.md). A página guarda apenas uma referência: ela mostra o nome da credencial, e as pessoas copiam ou exibem o seu valor a partir dali.

Se você colar ou escrever algo que pareça uma senha, um token ou uma chave, o editor pergunta o que fazer:

* **Guardar no cofre.** Cria a credencial e deixa uma referência na página.
* **Deixar como texto.** Mantém na página, sob a sua responsabilidade.
* **Deixar de fora.** Não adiciona.

## Pedir ajuda ao Teammate

Dentro do editor, o Teammate escreve ou reescreve a partir das páginas da sua organização:

* **Sem seleção**, pressione `Ctrl` + `J` (`⌘` + `J` no Mac) ou escolha **Pedir ao Teammate que escreva…** no menu `/`, e diga a ele o que escrever naquele ponto. **Escrever a próxima seção** continua a página.
* **Com um texto selecionado**, escolha **Perguntar ao Teammate** na barra de formatação e diga a ele o que fazer com o texto, ou use uma das opções rápidas: **Reescrever**, **Mais curto** ou **Transformar em passos**.

O texto aparece na página enquanto o Teammate o escreve. Quando ele termina, você pode **Desfazer** a alteração. `Esc` o interrompe.

> [!WARNING]
>
> O Teammate é uma função de IA: ele pode errar. Revise o que ele escreve antes de considerá-lo correto.

## Próximos passos

* [Alterações e histórico](https://docs.flexxible.com/pt-BR/features/flexxible-kb/history.md)
* [Comentários](https://docs.flexxible.com/pt-BR/features/flexxible-kb/comments.md)
* [Diagramas](https://docs.flexxible.com/pt-BR/features/flexxible-kb/diagrams.md)
