Editar e importar documentos Markdown

No editor de documentos do Studio, você pode trabalhar no texto já formatado: títulos aparecem como títulos, listas aparecem com marcadores e negrito aparece em destaque. A barra de ferramentas permite alterar esse conteúdo diretamente.

Visualização e Edição

Arquivos existentes abrem em Visualização. Nesse modo, você pode ler, selecionar e copiar o conteúdo, sem alterá-lo.

Para fazer mudanças:

1. Selecione Edição no alto do editor.
2. Clique no trecho que deseja alterar e edite o texto.
3. Use a barra de ferramentas para aplicar títulos, negrito, itálico, tachado, listas, citações, links ou tabelas.
4. Selecione Visualização para voltar à leitura.

A troca de modo mantém o conteúdo e o histórico de desfazer e refazer. Documentos novos começam em Edição.

Abrir um arquivo Markdown

Abra um arquivo .md ou .markdown em Arquivos. O documento aparece formatado no editor. Selecione Edição para começar a alterá-lo.

Novos documentos criados pela entrada Criar documento usam .md. O Studio salva as alterações no arquivo da pasta de trabalho e mostra o estado da gravação. Alternar os modos sem editar mantém o texto original do arquivo.

Importar Markdown para o documento aberto

A importação insere conteúdo na posição do cursor ou substitui o trecho selecionado. O arquivo escolhido para importar permanece intacto.

1. Ative Edição.
2. Posicione o cursor ou selecione o texto que deseja substituir.
3. Abra Inserir → Importar Markdown.
4. Escolha um arquivo .md ou .markdown, em UTF-8, de até 5 MB.
5. Revise o conteúdo inserido. Use Desfazer se quiser retirar a importação.

Por exemplo, uma linha # Proposta comercial vira um título, e linhas iniciadas por * ou - viram itens de lista.

Colar conteúdo Markdown

A colagem comum reconhece estruturas como títulos, listas e negrito. Quando você quiser indicar explicitamente que o texto deve ser interpretado como Markdown:

1. Ative Edição e posicione o cursor ou selecione o trecho que deseja substituir.
2. Abra Inserir → Colar como Markdown.
3. Cole o conteúdo no campo Texto em Markdown.
4. Selecione Inserir e revise o resultado formatado.

O conteúdo colado pode ser desfeito como uma única inserção. Em Visualização, a colagem não modifica o documento.

Conteúdo compatível

O editor preserva títulos, parágrafos, negrito, itálico, tachado, listas simples e numeradas, listas aninhadas, citações, links seguros, código e tabelas simples. Tabelas podem ter quebras de linha dentro das células.

As imagens usam arquivos locais PNG ou JPEG. Ao importar ou colar Markdown no documento aberto, os caminhos das imagens precisam corresponder aos recursos locais já disponíveis nesse documento. Imagens remotas ou caminhos que saem da pasta permitida são recusados.

Listas de tarefas com caixas de seleção, alinhamento de colunas de tabela e HTML embutido são incompatíveis com essa importação. A quebra de linha simples de uma tabela é uma exceção permitida. Quando há conteúdo incompatível, o Studio mostra um aviso e preserva o documento atual.

Formato e gravação

Documentos Markdown continuam salvos como Markdown. As ferramentas disponíveis nesse formato respeitam o que o arquivo consegue preservar; fonte, tamanho, cor e alinhamento por trecho não fazem parte dessa formatação.

Documentos HTML existentes mantêm seu formato e suas ferramentas de formatação rica. Importar Markdown para um documento HTML acrescenta o conteúdo formatado ao arquivo HTML, sem converter nem renomear o original.

O editor salva as alterações automaticamente. Se outro programa alterar o arquivo enquanto você trabalha, revise o aviso de conflito e escolha qual versão manter antes de continuar.