---
title: "Editor"
description: "Edição de Markdown puro, modos de escrita, formatação, foco e salvamento."
---

# Editor

O editor do Notarium sempre edita o **arquivo Markdown puro** — a única fonte da verdade. Faça o que fizer, o que vai para o disco é Markdown limpo, sem entulho: nada de reescape, sem renormalizar listas, sem colapsar o frontmatter. É isso que distingue o Notarium dos editores ricos, que guardam uma árvore normalizada e remontam o arquivo ao salvar — um ciclo que perde parte da formatação original. Por baixo dos panos está o CodeMirror 6: barra de formatação, atalhos de teclado, multicursor e realce de sintaxe.

![O editor no modo Source: Markdown puro com realce de sintaxe](/media/app-editor-light.webp)

## O título é a primeira linha

Não existe um campo "Title" separado. **O título de uma nota é seu `# H1` inicial**, que você edita direto no documento, na primeira linha. Uma nota nova abre já em uma linha `# `, com o cursor sobre o título.

- Se não houver um `# H1` inicial, o título passa a ser a primeira linha de **prosa** não vazia — uma anotação rápida não vira "Untitled".
- Mas se o documento abrir com um **bloco estrutural** (um bloco de código, lista, citação, tabela ou um título de nível H2 ou inferior) e nenhum título estiver definido, a nota **não salva sem título**: assim a primeira linha de código ou de uma lista não vaza silenciosamente para o título.

## Modos de escrita

Sobre o corpo único da nota ficam os modos de escrita — uma preferência pessoal de como o texto aparece enquanto você o edita. Um modo não muda os bytes do arquivo: é decoração sobre uma string inalterada, então trocar de modo e salvar são operações byte a byte idênticas.

| Modo | O que mostra |
|---|---|
| **Source** | Markdown puro como está: fonte monoespaçada, realce de sintaxe conforme o tema. Você edita a própria marcação. |
| **WYSIWYM** | "What you see is what you *mean*": o texto é estilizado (títulos maiores, negrito em negrito, citações e código com fundo), **mas os marcadores Markdown permanecem na tela**, esmaecidos — um andaime semântico. |

Você troca em **Settings → Appearance → Editor mode** (um controle segmentado `Source / WYSIWYM`). A escolha é pessoal, guardada no navegador; o padrão é **Source**.

> [!note] Pré-visualização é um eixo à parte
> O botão **Preview** na barra superior mostra o render HTML final da nota (o mesmo do modo de leitura) em qualquer modo, sem salvar. "Como eu trabalho" (Source/WYSIWYM) e "editar vs. visualizar" (Edit/Preview) são independentes.

## Foco e máquina de escrever

Sobre qualquer modo ficam dois auxiliares independentes para textos longos:

- **Focus** esmaece tudo, exceto a unidade ativa sob o cursor. A granularidade você escolhe — **Sentence / Line / Paragraph** (frase / linha / parágrafo). Atalho: `⌘/Ctrl+Shift+F`.
- **Typewriter** (máquina de escrever) mantém a linha do cursor centralizada verticalmente — o documento rola por baixo dela. Atalho: `⌘/Ctrl+Shift+Y`.

Ambos são interruptores pessoais que sobrevivem a um recarregamento. Você os ativa de três formas: pelo atalho, por dois ícones na barra de status do editor e por **Settings → Appearance** (onde também escolhe a granularidade do Focus).

## Salvamento e conflitos

Salve uma nota com **`Ctrl/Cmd+Enter`**. O Notarium protege contra a perda de trabalho não salvo e resolve o conflito quando a mesma nota é alterada em paralelo por outra aba ou por um agente de IA.

Um agente via MCP lê e escreve o mesmo corpo Markdown que uma pessoa — o modo de escrita não tem nada a ver com isso; ele é puramente do lado do cliente. Para mais sobre pessoas e agentes trabalhando juntos, veja [Pessoas e agentes](/docs/concepts/human-and-agents/); sobre histórico de versões, veja [Versionamento](/docs/concepts/versioning/).

Veja também: [Leitura e aparência](/docs/guides/reading/) — a fonte e o tamanho que o editor herda — e a [Referência de atalhos de teclado](/docs/reference/keyboard-shortcuts/).
