Markdown: modos, formatação e notas

Criar um Markdown novo

Dois caminhos:

• Barra de abas → nova aba → Markdown
• Comandos rápidos → novo arquivo Markdown

Os dois abrem um seletor de modelo: escolha um modelo e o arquivo nasce a partir dele.

Como isso funciona por dentro — e o que você precisa saber:

• O arquivo é escrito no disco já na criação, e renomeado depois. Ele existe antes de você digitar qualquer coisa.
• Fechar sem editar remove o placeholder: se você criou e não escreveu nada, o arquivo não fica para trás.
• Um modelo com conteúdo real muda esse comportamento: nesse caso o arquivo não é removido ao fechar sem edições.

Salvar ou renomear um arquivo novo

O diálogo de salvar pede nome e pasta:

• O nome não pode ser vazio nem conter barras.
• A pasta precisa estar dentro do workspace.
• Erros de validação aparecem no próprio diálogo, não como aviso solto.
• A pasta pode ser escolhida no seletor do sistema.

Os três modos de Markdown

Modo	O que faz
Fonte	Mostra o texto Markdown como ele é
Rico	Edição com formatação aplicada
Pré-visualização	Renderiza o resultado, sem editar

• Pré-visualização ao lado abre o render num painel separado, mantendo o texto à vista.
• Sumário (Table of Contents) está disponível nos modos rico e pré-visualização — no modo fonte, não.
• Mostrar/ocultar front matter alterna a exibição do cabeçalho do documento.
• Exportar como PDF gera um PDF do documento. A exportação fica indisponível quando não há conteúdo renderizado para exportar — ou seja, no modo fonte não há o que exportar.

O modo “Alterações” é mutuamente exclusivo com os modos de Markdown em tempo de render. Escolher Alterações sai do modo Markdown; voltar para Markdown sai de Alterações.

Edição rica

No modo rico, o documento é editado com formatação aplicada, e a superfície oferece:

• Barra de formatação — negrito, itálico, títulos, listas, tabela, imagem e link.
• Menu de comandos — comandos acionados pela barra.
• Menu de emoji.
• Balão de link — editar, abrir ou remover o link sob o cursor.
• Menu de link para documento interno — aponta para outro documento em vez de uma URL externa.
• Barra de busca no documento.

A mesma barra de formatação aparece na nota do Canvas. Ali ela pertence ao domínio do Canvas; esta página cobre o uso dentro do editor de arquivos.

Notas de revisão

Notas de revisão são anotações ancoradas a trechos de texto do documento — um comentário preso à frase, não ao arquivo.

• O trilho de notas mostra e oculta as notas, com um botão de alternância.
• Cada nota é um cartão que pode ser copiado, editado e apagado.
• As notas podem ser enviadas ao agente por um menu próprio.
• As notas exigem o modo rico com anotações habilitadas.

Limite importante: as notas são ancoradas a trechos, e o posicionamento depende do layout do documento. Alterações no texto podem deslocar as âncoras — se você editar bastante depois de anotar, confira se cada nota continua apontando para o trecho certo.

Limites

• Exportar PDF depende de haver documento renderizado.
• Sumário não existe no modo fonte.
• Notas de revisão exigem modo rico com anotações habilitadas e podem deslocar quando o texto muda.

Relacionados

• O editor