Converter um documento do Word em Markdown mantém a estrutura e perde a aparência. Títulos, negrito, itálico, links, listas com marcadores e tabelas simples passam. Cores, fontes, alinhamento, espaçamento e layout de página não, porque o Markdown não tem sintaxe para eles. Algumas coisas intermediárias saem alteradas: listas numeradas, células mescladas e código. Outras, como comentários e caixas de texto, somem. O conversor de Word para Markdown roda na aba, e esta página lista o que o código dele faz em cada caso, conferido contra a fonte.
Quais partes de um documento do Word passam limpas para o Markdown?
As que o Markdown foi feito para representar. Um parágrafo com estilo de título vira uma linha começando com cerquilhas, no mesmo nível, de 1 a 6. Negrito, itálico e tachado viram **, * e ~~. Um hiperlink externo vira [texto](endereço). Uma lista com marcadores vira itens com -, com o aninhamento mantido pelo recuo. Uma quebra de página manual vira uma linha horizontal. Os caracteres que o Markdown leria como formatação, como um asterisco ou um sublinhado literal no seu texto, são escapados para continuarem literais.
Os títulos são reconhecidos pelo estilo do parágrafo, não pela aparência do texto. Se alguém fez um título selecionando uma linha e pondo em negrito com 18 pontos, o conversor vê um parágrafo em negrito, e você recebe **Introdução** em vez de um título. O mesmo vale para o estilo Título do Word, que não é um nível de título. Antes de converter um documento que você não escreveu, abra o painel de Estilos ou o painel de Navegação no Word. Se a estrutura de tópicos estiver vazia, a saída também não terá títulos.
O espaçamento é a outra coisa que some sem deixar sinal. Parágrafos vazios são ignorados, uma tabulação vira quatro espaços e os espaços no início de um parágrafo são cortados. O Markdown trata linhas em branco como o limite entre blocos, então o ar extra que algumas pessoas deixam entre seções com linhas vazias não tem para onde ir.
O que acontece com as tabelas e com as células mescladas?
Uma grade simples converte bem. A definição original do Markdown não tem tabelas; elas vêm da especificação GitHub Flavored Markdown, que as lista como uma extensão do CommonMark. A maioria das wikis e das ferramentas de sites estáticos as lê, e um processador CommonMark estrito não. Por isso o conversor oferece tabelas HTML como alternativa para um processador que só conhece a sintaxe básica.
As células mescladas são onde uma tabela deixa de converter bem. Nem as tabelas com barras nem a saída HTML do conversor carregam mesclagem de colunas ou de linhas. O conversor lê cada célula de cada linha uma única vez e não lê a configuração de mesclagem, então uma célula de título esticada por três colunas vira uma célula, e a linha fica mais curta que as outras. Linhas curtas são completadas com células vazias à direita, o que pode deixar o texto na coluna errada. Uma célula mesclada na vertical deixa células vazias abaixo. A especificação GFM diz que as células que faltam em uma linha são preenchidas com vazias, então outras ferramentas tratam uma linha curta do mesmo jeito. Confira qualquer tabela que tinha mesclagens antes de confiar nela.
Mais dois fatos sobre tabelas. A primeira linha sempre vira a linha de cabeçalho, porque uma tabela com barras precisa de uma, tenha o Word marcado como cabeçalho ou não. E uma célula com vários parágrafos é unida em uma só linha com espaços, porque uma célula de tabela com barras não pode conter uma quebra de linha. Uma tabela aninhada dentro de uma célula é descartada.
O que é descartado, e o conversor avisa?
De algumas coisas ele avisa. A ferramenta mostra um aviso quando o documento tem imagens (ficam de fora, porque o Markdown se refere a uma imagem por um caminho e as imagens vivem dentro do arquivo), várias colunas (o texto sai em uma só), alterações controladas, cabeçalhos e rodapés, e notas de rodapé. Os avisos de cabeçalhos, rodapés e notas de rodapé são disparados porque essas partes existem no arquivo, então um aviso pode aparecer por uma parte quase vazia.
De outras ele não avisa. Os comentários na margem não são lidos, e o texto ao qual estavam presos fica no corpo sem sinal de que houve um comentário. O texto dentro de uma caixa de texto não passa; o aviso diz que imagens ficaram de fora, mas o texto em uma caixa também se perde. As propriedades do documento, como autor e título, são lidas mas não escritas na saída, então não há front matter. Se o seu gerador de sites estáticos espera um, você o acrescenta à mão.
As alterações controladas são resolvidas como o Word as mostra com as alterações aceitas: o texto inserido é mantido e o excluído é descartado. Isso é conveniente quando você quer a versão limpa e errado quando o objetivo do documento era a revisão. Aceite ou rejeite as alterações no Word primeiro se quiser decidir você, e não o conversor.
Por que as listas numeradas e o código saem errados?
As listas numeradas saem como marcadores. O Word guarda as regras de numeração em uma parte separada do arquivo, com reinícios e substituições, e o conversor não as lê. Um marcador é uma perda que se vê, enquanto uma sequência adivinhada poderia estar errada sem que se perceba. A correção é digitar de novo 1. no início dos itens, o que leva segundos. No Markdown, na maioria dos processadores só o primeiro número de uma lista importa, então você pode numerar todos com 1. e deixar o renderizador contar.
O código é a outra surpresa. O texto em uma fonte monoespaçada como Courier, Consolas ou Menlo vira código em linha, entre crases. Uma listagem de código de várias linhas no Word são vários parágrafos, então você recebe vários trechos de código de uma linha, não um único bloco delimitado. Envolva essas linhas em um bloco delimitado à mão. As notas de rodapé têm uma lacuna parecida: as notas não são escritas, a marca de referência no texto também não, e a sintaxe de notas de rodapé não faz parte da especificação básica de qualquer forma.
Depois de uma conversão, compare o Markdown com o original. Colar os dois em uma comparação de textos vai marcar cada título que virou uma linha em negrito e cada lista que mudou. E se o problema são as aspas tipográficas e os espaços estranhos que o Word acrescentou, isso é outra etapa; por que o texto colado do Word dá errado explica.
Quando o Markdown é o destino errado?
Quando o layout é o conteúdo. Um formulário, um folheto, uma carta com papel timbrado, um currículo com layout de duas colunas ou um documento com figuras e legendas perde a maior parte do que faz dele aquele documento. O Markdown serve para texto que será estilizado por outra coisa depois: um README, uma página de wiki, um post de blog, anotações. Se você precisa que o documento fique igual do outro lado, converta-o em PDF e leia o que muda quando o Word vira PDF.
O conversor lê apenas .docx. Um .doc antigo é outro formato binário, e um arquivo .pages ou um arquivo renomeado não abre. Tudo é lido no seu navegador e nada é enviado, o que você pode conferir na aba Rede das ferramentas do desenvolvedor do seu navegador.
Se você tem um .docx para converter, o conversor de Word para Markdown lista ao lado do resultado o que deixou de fora, e você pode escolher títulos com cerquilhas ou sublinhados e tabelas com barras ou HTML antes de copiar ou baixar.
Se o arquivo está cheio de aspas parecidas e espaços estranhos, por que o texto colado do Word dá errado cobre esse problema à parte.
Perguntas frequentes
O que se perde ao converter Word em Markdown?
Tudo o que é aparência: cores, fontes, tamanhos, alinhamento, espaçamento e layout de página. Este conversor não leva imagens, caixas de texto, comentários, cabeçalhos, rodapés nem notas de rodapé, e as listas numeradas saem como marcadores. Títulos, negrito, itálico, links, listas com marcadores e tabelas simples são mantidos.
Por que meus títulos não viraram títulos no Markdown?
O conversor reconhece os títulos pelo estilo do parágrafo, como Título 1 a Título 6, não pela aparência do texto. Uma linha que só recebeu negrito e um tamanho maior sai como um parágrafo em negrito. Aplique estilos de título de verdade no Word e converta de novo, e os níveis passarão.
O que acontece com as células mescladas de uma tabela?
As tabelas de Markdown não têm mesclagem de colunas nem de linhas, e este conversor não lê a configuração de mesclagem. Uma célula mesclada vira uma célula, as linhas curtas são completadas com células vazias à direita, e o texto pode acabar na coluna errada. Confira com o original qualquer tabela que tinha células mescladas.
Converter Word em Markdown mantém as alterações controladas e os comentários?
As alterações controladas são resolvidas como o Word as mostra: o texto inserido é mantido e o excluído é descartado, e a ferramenta avisa. Os comentários não são lidos de forma alguma, então o texto comentado fica no corpo sem rastro do comentário. Aceite ou rejeite as alterações no Word primeiro se a revisão importar.
O arquivo do Word é enviado quando eu o converto?
Não. Um .docx é um arquivo zip com XML dentro, e o conversor o abre e o lê na aba do seu navegador. O arquivo não é enviado a lugar nenhum, e a aba Rede das suas ferramentas do desenvolvedor não mostrará nenhum envio enquanto você converte.
Última atualização 13 de novembro de 2026