Markdown para Word

Por que os títulos precisam ser estilos, e não texto grande

Se você colar o Markdown no Word do jeito que está, continua vendo as cerquilhas; se colar a partir de alguma prévia, os títulos viram texto grande em negrito, que parece um título mas não é um título para o Word. A diferença aparece assim que você tenta fazer qualquer coisa séria: o sumário automático fica vazio, o painel de navegação não mostra estrutura, os níveis não podem ser recolhidos e a numeração de capítulos nunca começa. Aqui os títulos usam os estilos Título 1, Título 2 e Título 3 do Word, exatamente o que o programa espera.

O que é convertido

Títulos de uma a seis cerquilhas, negrito, itálico, tachado, código em linha e blocos de código delimitados por três crases.

Listas com marcadores e numeradas, aninhadas em vários níveis e também misturadas; uma lista numerada que recomeça do 1 realmente começa do 1, e uma que começa no 5 começa no 5.

Tabelas com a linha de cabeçalho em negrito sobre fundo cinza, repetida no topo de cada página, alinhadas à direita ou centralizadas se você indicar com dois-pontos na linha de traços.

Citações em bloco, linhas horizontais, listas de tarefas com caixas de seleção e links clicáveis (incluindo endereços web e de e-mail escritos soltos no texto).

Links para uma seção do mesmo texto, como [ver](#resumo): o título correspondente recebe um indicador do Word, então no arquivo .docx o link realmente leva até lá. Se esse título não existir, o texto fica simples e você recebe um aviso, em vez de um link azul que não leva a lugar nenhum. Na cópia para a área de transferência esses saltos ficam como texto simples: um link interno vive dentro do documento e, no momento em que sai desta página, não tem para onde saltar.

O documento é A4 com margens de 2 cm, Calibri 11 para o texto e Consolas para o código.

Copiar para a área de transferência ou baixar o arquivo

O botão laranja coloca na sua área de transferência tanto a versão formatada quanto o texto simples: cole no Word online, no Google Docs, num e-mail ou numa mensagem e ele chega já formatado, sem arquivo no meio. É o caminho mais rápido quando o texto precisa entrar num documento que já existe. O arquivo .docx é o que você quer quando o documento precisa ser entregue, anexado ou arquivado: é um arquivo Word comum, e abre no Word, no LibreOffice, no Pages e no Google Docs.

O sumário se atualiza na primeira abertura

Se você marcar “Adicionar um sumário”, o documento começa com um campo de sumário de verdade. Ele sai vazio, e não poderia ser diferente: os números das páginas dependem de fontes e margens, então só o programa que abre o arquivo os conhece. Na primeira vez que você o abre, o Word pergunta se deve atualizar os campos: diga que sim e o sumário se preenche sozinho. Se não perguntar, clique com o botão direito na caixa e escolha Atualizar campo, ou vá à guia Referências e escolha Atualizar Sumário.

O que fica de fora, dito logo de início

As imagens não entram no documento: o Markdown leva só o endereço delas, e esta página nunca baixa nada da rede, então a legenda entre colchetes ocupa o lugar. O HTML escrito dentro do Markdown, as fórmulas de LaTeX, as notas de rodapé e os links por referência como [1]: endereço não são interpretados. Tabelas dentro de tabelas não existem em Markdown, então aqui também não existem. O código precisa ser delimitado por três crases: o código marcado só com recuo de quatro espaços fica como texto simples, e uma linha de três traços é sempre uma linha horizontal, nunca um título. Se uma tabela não tem a linha de traços embaixo do cabeçalho, ela não é uma tabela para ninguém, nós incluídos: você recebe um aviso em vez de colunas inventadas.

Tudo no seu navegador, até offline

O documento Word é montado aqui mesmo, byte a byte: um arquivo .docx é um pacote ZIP com arquivos XML dentro, e esta página escreve tanto o XML quanto o ZIP. O texto que você cola nunca sai do seu dispositivo, nunca é enviado e nunca é armazenado: você pode desligar a rede e a página continua funcionando. Essa é a diferença que importa quando o texto é uma ata, um laudo técnico ou uma revisão confidencial.