---
id: "arquivos-markdown"
titulo: "Markdown: modos, formatação e notas"
resumo: "Criar um Markdown novo, alternar entre fonte, rico e pré-visualização, usar a edição rica e anotar um documento para revisão."
idioma: "pt-br"
tipo: "guia"
categoria: "arquivos-git"
aplicavelDesde: "0.0.16"
capabilities: ["editor.markdown.views", "editor.markdown.richFormatting", "editor.newMarkdown.untitled", "editor.untitledRename", "review.markdown.notes"]
estadoEditorial: "aprovado"
nivelEvidencia: "artefato-distribuido"
refFonte: "27574c339b58316408f6be2d62169d59041d07bf"
revisaoFonte: "2026-09-24"
revisor: "mantenedor (v1, 2026-10-03)"
rota: "/docs/pt-br/ferramentas/arquivos/markdown/"
fonte: "pt-br/ferramentas/arquivos/markdown.md"
caminhoPublico: "docs/publica/pt-br/ferramentas/arquivos/markdown.md"
hashFonte: "sha256:eb4a2c85a0ab78a4c9c5e4e8de0dbcd1716168075254804e11c6d571175d0e36"
hashDestaPagina: "sha256:eb4a2c85a0ab78a4c9c5e4e8de0dbcd1716168075254804e11c6d571175d0e36"
traducaoAssistidaPorIA: false
traducaoDesatualizada: false
corpoRetido: false
---
## 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](/docs/pt-br/ferramentas/arquivos/editor/)