Como formatar trechos de código em documentos do Word

Ao colar código de um editor no Word, o texto simples geralmente perde indentação, cor e clareza da fonte. Isso dificulta a leitura e revisão. O Word não possui um editor de código integrado, mas oferece várias ferramentas para preservar ou recriar a formatação do código. Este artigo explica como usar estilos do Word, opções de colar e ferramentas externas para formatar trechos de código de forma legível e estruturada.

Entendendo como o Word lida com código de outras fontes

Ao copiar código de um Ambiente de Desenvolvimento Integrado ou editor de texto, o Word recebe o texto mais qualquer formatação aplicada pela fonte. Muitos IDEs usam realce de sintaxe com texto colorido, fontes diferentes e indentação baseada em tabulação. O Word preserva esses atributos se você colar com a opção padrão. O resultado geralmente fica confuso porque o Word reorganiza o texto para caber nas margens da página, quebrando linhas longas e desalinhando a indentação.

O Word não entende linguagens de programação. Ele trata cada linha como um parágrafo. Caracteres de tabulação da fonte podem aparecer como espaços de largura variável. Fontes monoespaçadas como Consolas ou Courier New mantêm o alinhamento da largura dos caracteres, mas o Word usa fontes proporcionais como Calibri por padrão. Para manter o código legível, você precisa substituir esses padrões.

O objetivo principal é preservar três coisas: uma fonte monoespaçada, a indentação original e um fundo distinto que separe o bloco de código do texto ao redor. Você pode conseguir isso usando estilos do Word, opções de colar ou objetos incorporados. Cada método tem vantagens e desvantagens em velocidade, fidelidade e editabilidade.

Métodos para formatar trechos de código no Word

Método 1: Colar e aplicar um estilo de código personalizado

Este método funciona para trechos curtos que você cola com frequência. Você cria um estilo do Word que imita a aparência de um editor de código e o aplica após colar.

1. Copie o código da sua fonte
   Selecione o código no editor e pressione Ctrl+C.
2. Cole no Word sem formatação
   No Word, clique com o botão direito e escolha Opções de Colar > Manter apenas texto. Isso remove todas as cores e fontes da fonte.
3. Crie um novo estilo para código
   Na guia Página Inicial, clique na pequena seta no grupo Estilos para abrir o painel Estilos. Clique no botão Novo Estilo na parte inferior. Nomeie o estilo como CodeBlock.
4. Defina a fonte e o tamanho
   Na caixa de diálogo Criar Novo Estilo a partir da Formatação, escolha Formatar > Fonte. Defina a Fonte como Consolas ou Courier New. Defina o Tamanho como 10 pt. Clique em OK.
5. Adicione uma cor de fundo
   Ainda na caixa de diálogo, escolha Formatar > Bordas. Na janela Bordas e Sombreamento, vá para a guia Sombreamento. Escolha um preenchimento cinza claro, por exemplo Cinza-10%. Clique em OK duas vezes.
6. Ajuste o espaçamento entre parágrafos
   Selecione Formatar > Parágrafo. Defina Espaçamento Antes e Depois como 0 pt. Defina Espaçamento entre linhas como Simples. Clique em OK.
7. Aplique o estilo ao código colado
   Selecione o texto colado. No painel Estilos, clique em CodeBlock. O Word aplica a fonte monoespaçada, o fundo cinza e o espaçamento simples.

A vantagem é que você pode reutilizar o mesmo estilo em todo o documento. A desvantagem é que o realce de sintaxe é perdido. Todo o código aparece em uma cor.

Método 2: Usar Colar especial para incorporar rich text de um editor

Alguns editores, como o Visual Studio Code com a extensão Copy with Syntax Highlighting, copiam código como rich text que inclui cores e fontes. O Word pode preservar parte dessa formatação.

1. Copie de um editor que suporte cópia de rich text
   No Visual Studio Code, selecione o código e pressione Ctrl+Shift+C. Ou use uma extensão que copie com formatação.
2. Cole no Word usando Colar especial
   No Word, vá para Página Inicial > Colar > Colar especial. Na caixa de diálogo, selecione Texto formatado (RTF) e clique em OK.
3. Verifique o resultado
   O Word mantém as cores da fonte, realces de fundo e fonte monoespaçada da fonte. Linhas longas ainda podem quebrar. Para evitar quebras, selecione o bloco de código e, na guia Página Inicial, clique em Configuração de Parágrafo. Na guia Recuos e Espaçamento, defina Espaçamento entre linhas como Múltiplo e insira um valor como 0,8 para reduzir o texto, ou quebre manualmente linhas longas com Shift+Enter.

Este método preserva o realce de sintaxe, mas depende do editor de origem. Nem todos os editores copiam formatação rich. Além disso, se você editar o código posteriormente no Word, as cores podem não ser atualizadas.

Método 3: Incorporar um trecho de código como objeto de texto do OpenDocument

Este método insere um mini-documento separado dentro do documento principal. O código vive em seu próprio contêiner com formatação independente.

1. Posicione o cursor onde deseja o bloco de código
   Clique no documento no ponto de inserção.
2. Insira um objeto de texto do OpenDocument
   Vá para Inserir > Texto > Objeto. Na caixa de diálogo Objeto, selecione Texto do OpenDocument e clique em OK. O Word insere um quadro de documento incorporado vazio.
3. Cole o código no documento incorporado
   Clique duas vezes dentro do quadro. O Word abre uma superfície de edição separada. Cole o código da sua fonte usando Ctrl+V. O documento incorporado tem sua própria fonte padrão, que você pode alterar para Consolas.
4. Ajuste o tamanho do documento incorporado
   Clique fora do quadro para retornar ao documento principal. Arraste as alças do quadro para redimensioná-lo de modo que todas as linhas de código fiquem visíveis. Se o código for longo, redimensione a altura do quadro.

O objeto incorporado mantém o código isolado. Alterações nos estilos do documento principal não afetam o código. No entanto, o código é mais difícil de editar porque você precisa clicar duas vezes no objeto para acessá-lo. Além disso, o objeto pode se deslocar se você adicionar ou remover texto acima dele.

Erros comuns e limitações ao formatar código

O Word quebra linhas longas de código

O Word trata cada linha como um parágrafo e quebra o texto na margem direita. Isso quebra a estrutura visual do código. Para evitar quebras, selecione o bloco de código, abra as configurações de Parágrafo e, em Recuo, defina Esquerda para um valor pequeno como 0,5 polegadas. Ou defina o recuo Direito para um valor negativo para estender a área de texto. Uma correção mais confiável é reduzir o tamanho da fonte para 8 pt ou 9 pt para que as linhas caibam na largura da página.

Caracteres de tabulação são convertidos em espaços ou largura variável

Ao colar como texto simples, o Word pode converter tabulações em espaços ou exibi-las como lacunas inconsistentes. Para corrigir isso, após colar, pressione Ctrl+H para abrir Localizar e Substituir. Em Localizar, digite ^t. Em Substituir por, digite quatro espaços. Clique em Substituir tudo. Isso garante indentação uniforme.

O realce de sintaxe é perdido após a edição

Se você colar código com realce de sintaxe usando o Método 2, editar o código no Word não reaplica o realce. As cores permanecem estáticas. Para atualizar o realce, exclua o bloco de código antigo e cole novamente do editor de origem com formatação.

Objetos incorporados aumentam o tamanho do arquivo

Cada objeto de texto do OpenDocument adiciona sobrecarga ao arquivo .docx. Se você incorporar muitos blocos de código, o tamanho do arquivo aumenta. Para documentos grandes com muitos trechos, use o Método 1 com um estilo personalizado para manter o arquivo pequeno.

Comparação dos métodos de formatação de código no Word

Recurso	Estilo personalizado (Método 1)	Colar rich text (Método 2)	Objeto incorporado (Método 3)
Realce de sintaxe	Não	Sim, da fonte	Se colado com formatação
Editabilidade no local	Sim, como texto normal	Sim, mas cores estáticas	Clique duplo no objeto
Impacto no tamanho do arquivo	Mínimo	Mínimo	Moderado a alto
Reutilizável no documento	Sim, estilo é global	Não	Não
Preserva indentação	Correção manual necessária	Geralmente preservada	Preservada

Agora você pode formatar trechos de código no Word usando um estilo personalizado, colar rich text ou um objeto incorporado. Para documentos com muitos blocos de código, comece criando um estilo CodeBlock reutilizável. Para um único trecho com cores de sintaxe, use o método de colar rich text. Se precisar manter o código completamente separado da formatação principal, incorpore-o como um objeto de texto do OpenDocument. Para agilizar a formatação, atribua o estilo CodeBlock a um atalho de teclado indo em Arquivo > Opções > Personalizar Faixa de Opções > Atalhos do Teclado > Estilos e selecionando seu estilo.