IA no seu dispositivo — profissional e privado.

Documentos

Como converter Word em Markdown (DOCX para .md com tabelas, links e imagens)

Converta Word em Markdown on-line: títulos, listas, tabelas, links e imagens passam limpos. Veja o que não dá para converter (layout, comentários, cores) e por quê.

Atualizado em 8 de novembro de 20269 min de leitura

Para converter Word em Markdown, abra um conversor de DOCX para Markdown, adicione seu arquivo .docx e copie ou baixe o resultado .md. O que passa para o outro lado é a estrutura do documento: títulos viram linhas com #, listas com marcadores e numeradas viram itens - e 1., negrito e itálico viram ** e *, os links continuam clicáveis, as tabelas viram tabelas com barras verticais e as imagens viram referências de imagem. O que não passa é a aparência da página. Markdown é texto puro com um pouco de pontuação, então fontes, cores, margens, colunas e comentários do Word não têm onde ficar. Saber de que lado dessa linha está cada parte do seu documento é a diferença entre um arquivo limpo e uma tarde inteira consertando tudo à mão.

Como converter Word em Markdown, passo a passo

1

Adicione o arquivo .docx

Abra o conversor de Word para Markdown e arraste o documento até ele, ou clique em "Escolher arquivo". Só é aceito .docx. Um arquivo .doc antigo é recusado com uma mensagem, porque é outro formato: abra-o no Word ou no Google Docs e salve como .docx primeiro. A conversão começa sozinha.

2

Escolha a variante de Markdown

Deixe em GitHub para GitHub, GitLab, a maioria das wikis e a maioria dos geradores de sites estáticos. Escolha CommonMark só para um analisador rígido, ou Pandoc se o arquivo for passar por um fluxo com Pandoc. A tabela mais abaixo mostra o que muda.

3

Decida o que acontece com as imagens

Em "Imagens incorporadas", escolha Extrair (as imagens vão para uma pasta images e o download vira um ZIP), Inline (as imagens são gravadas dentro do próprio arquivo .md) ou Deixar de fora.

4

Ajuste os extras opcionais

"Descer títulos" empurra cada título de um a três níveis para baixo, para que um documento cujo título é Título 1 possa ficar abaixo de um título de página que já existe. "Largura de linha" quebra os parágrafos em 80 ou 100 colunas, ou não quebra. "Acrescentar front matter YAML" grava no início do arquivo o título, o autor, o assunto, as palavras-chave e as datas das propriedades do documento.

5

Confira a prévia e depois copie ou baixe

Alterne entre "Fonte" (o texto exato que você vai levar) e "Renderizado" (como um visualizador de Markdown vai exibi-lo). Depois clique em "Copiar", em "Baixar .md" ou baixe o ZIP se tiver extraído imagens. Cada ajuste atualiza a prévia na hora, então teste alguns antes de decidir.

O que converte de forma limpa

Tudo o que descreve a estrutura do texto tem um equivalente em Markdown ou uma alternativa segura em HTML, e o conversor grava isso em vez de achatar tudo em parágrafos simples.

No WordNo arquivo MarkdownVale saber
Estilos Título 1 a Título 6Títulos de # a ######Só conta o texto com um estilo de título de verdade; texto grande em negrito continua sendo parágrafo
Listas com marcadores e numeradasItens - e 1.O aninhamento é mantido em qualquer profundidade
Negrito, itálicoAsteriscos duplos e simples em volta do textoTexto num estilo de caractere de código vira código em linha
Tachado~~texto~~No CommonMark é gravado como HTML <s>
HiperlinksLinks em MarkdownO texto do link e o endereço são mantidos
TabelasTabelas com barras e alinhamento de colunasCélulas mescladas ou listas dentro de uma célula fazem essa tabela virar HTML
Notas de rodapé e notas de fimReferências [^1] com as definições no finalNo CommonMark, uma lista HTML numerada
ImagensReferências de imagem como images/image-1.pngO texto alternativo definido no Word vira a descrição da imagem
Estilos de parágrafo de citação e de códigoBlocos de citação com > e blocos de códigoReconhecidos pelos nomes de estilo do Word, como Quote e Code
Sublinhado, realce, sobrescrito, subscritoHTML <u>, <mark>, <sup>, <sub>O Pandoc grava ^sup^ e ~sub~ no lugar

As tabelas merecem uma observação à parte. O alinhamento das colunas (esquerda, centro, direita) é lido do documento e gravado como ---, :---: e ---:. Se o Word marcou uma linha como linha de cabeçalho repetida, ela vira o cabeçalho; se nenhuma estiver marcada, a primeira linha é usada, porque uma tabela com barras precisa de uma. Uma barra vertical dentro de uma célula é escapada para não dividir a coluna, e dois parágrafos na mesma célula são unidos com uma quebra de linha. Quando uma tabela usa células mescladas, o Markdown simplesmente não tem sintaxe para isso, então essa tabela é gravada como HTML, que todos os visualizadores de Markdown comuns exibem corretamente. O cartão do resultado informa quantas tabelas seguiram esse caminho.

O que não dá para converter, e por quê

O Markdown foi criado para descrever o que um texto é, não como ele parece. Os itens abaixo não se perdem por causa de um conversor fraco; simplesmente não existe Markdown para escrevê-los.

  • Layout da página. Margens, tamanho da página, quebras de página, quebras de seção, várias colunas de texto e a posição de imagens ou caixas de texto flutuantes. Um arquivo Markdown não tem páginas; é um único fluxo de texto que o destino diagrama.
  • Comentários. Os comentários de revisão na margem não são gravados no arquivo .md. Se eles importam, resolva-os ou copie-os para outro lugar antes de converter.
  • Cores, fontes e tamanhos. Cor da fonte, família da fonte, tamanho em pontos e espaçamento entre linhas são descartados. O realce só é mantido como tag <mark>, que a maioria dos visualizadores mostra na cor padrão deles, não na sua.
  • Cabeçalhos e rodapés. Cabeçalhos, rodapés e números de página pertencem ao layout da página e não fazem parte do texto convertido.
  • Alinhamento de parágrafos comuns. Texto centralizado ou alinhado à direita vira parágrafo comum alinhado à esquerda. Só as colunas das tabelas mantêm o alinhamento.
  • Formatação manual fingindo ser estrutura. Uma linha em negrito e em 16 pt parece título no Word, mas para qualquer conversor é só um parágrafo. Linhas iniciadas com um traço ou número digitado, em vez de uma lista de verdade, viram parágrafos que começam com esse caractere.

Qual variante de Markdown escolher

Markdown é uma família de dialetos. Eles concordam em títulos, listas, ênfase e links e discordam no resto, e a escolha errada aparece como tis e barras soltos na página.

VarianteTabelasTachado e notas de rodapéUse para
GitHub (padrão)Tabelas com barras~~texto~~ e [^1]GitHub, GitLab, wikis, a maioria dos geradores de sites estáticos e apps de notas
CommonMarkTabelas HTMLHTML <s> e uma lista numerada de notasAnalisadores rígidos que recusam extensões
PandocTabelas com barras~~texto~~ e [^1], mais ^sup^ e ~sub~Arquivos que o Pandoc vai converter de novo

Na dúvida, fique com GitHub. A saída CommonMark é correta em qualquer lugar, mas mais longa, porque cada tabela e cada nota de rodapé recorrem ao HTML.

Imagens: extrair, inline ou deixar de fora

Extrair é a escolha certa para um repositório, um site de documentação ou um gerador de sites estáticos. Cada imagem é salva como images/image-1.png, images/image-2.png e assim por diante, o Markdown aponta para esses caminhos relativos e o download é um ZIP com o arquivo .md e a pasta. Descompacte tudo junto para que os caminhos continuem funcionando. Inline transforma cada imagem em um URI de dados dentro do texto. O arquivo não precisa de nada ao lado, mas uma única foto pode acrescentar megabytes de caracteres ilegíveis, então use só para trechos curtos colados onde não dá para hospedar arquivos. Deixar de fora não grava nenhuma referência de imagem, o que serve para uma migração em que as imagens já estão hospedadas em outro lugar.

No plano gratuito, as imagens extraídas são gravadas com até 4096 pixels no lado mais longo, mais do que qualquer página de documentação normal chega a exibir. O Pro mantém a resolução original.

Tabelas, notas de rodapé, links, imagens e front matter YAML, nas variantes GitHub, CommonMark ou Pandoc. Grátis: um .docx por vez de até 50 MB, todos os ajustes de conversão incluídos, imagens de até 4096 px. Pro: lotes de até 50 documentos em um ZIP e imagens em resolução total. Tudo roda no seu dispositivo, não nos nossos servidores.

Converter Word em Markdown

Para um resultado limpo, prepare o documento antes

  1. 1Aplique estilos de título de verdade em todos os títulos e garanta que haja só um Título 1 se o arquivo for virar uma única página.
  2. 2Use os botões de marcadores e numeração do Word para as listas, não traços ou números digitados.
  3. 3Adicione texto alternativo às imagens (clique com o botão direito na imagem e escolha a opção de texto alternativo). Ele vira a descrição da imagem no Markdown, que leitores de tela e buscadores leem.
  4. 4Desfaça a mesclagem de células sempre que puder. Uma grade simples vira uma tabela com barras fácil de ler; uma mesclada vira HTML.
  5. 5Preencha Arquivo > Informações > Propriedades (título, autor, assunto, marcas) se quiser um front matter YAML útil.
  6. 6Se o arquivo passar de 50 MB, a culpa quase sempre é das imagens. Comprima o documento do Word primeiro e veja comprimir um documento do Word para saber o que isso muda.

Quando Markdown é o destino errado

Markdown é ideal quando o texto vai ser editado, versionado ou publicado por um site que aplica o próprio estilo. Se a ideia é manter o documento exatamente com a aparência que tem no Word, é o formato errado. Para uma cópia para impressão que mantém cada página como foi diagramada, use Word para PDF; o que sobrevive à conversão de Word para PDF trata de fontes e layout. Se o destino quer HTML em vez de Markdown, o Word para HTML grava direto. Se você só precisa das palavras, o Word para texto entrega texto puro, sem marcação para limpar.

Se a sua tabela nasceu numa planilha e não num documento do Word, pule o Word de vez: converter CSV em Markdown explica como transformar os dados direto numa tabela com barras com a ferramenta CSV para Markdown.

Perguntas frequentes

Como converto um documento do Word em Markdown?

Adicione o .docx ao conversor de Word para Markdown, escolha uma variante (GitHub é o padrão), decida o que acontece com as imagens, confira a prévia "Renderizado" e clique em "Copiar" ou "Baixar .md". No grátis, você converte um documento por vez de até 50 MB.

Dá para converter DOCX em Markdown com tabelas?

Sim. As tabelas do Word viram tabelas com barras, com o alinhamento das colunas lido do documento. Uma tabela com células mescladas, ou com uma lista dentro de uma célula, não tem equivalente com barras, então é gravada como tabela HTML, que os visualizadores de Markdown exibem normalmente.

Por que meus títulos viram texto comum depois de converter?

O documento usou texto em negrito ou maior em vez dos estilos de título do Word. Um conversor só reconhece um título que esteja marcado como título. Aplique Título 1, 2 ou 3 no Word e converta de novo.

Os comentários e as cores de fonte do Word ficam no Markdown?

Não. O Markdown não tem sintaxe para comentários de revisão, cores de fonte, fontes, tamanhos ou layout de página, então eles não são gravados no arquivo .md. O realce fica como tag <mark> e o sublinhado como <u>.

Dá para converter um arquivo .doc em Markdown?

Não diretamente. Só é aceito .docx. Abra o arquivo .doc no Word ou no Google Docs, salve ou baixe como .docx e converta esse arquivo.

Dá para converter vários arquivos do Word em Markdown de uma vez?

A conversão em lote é um recurso Pro: até 50 documentos de uma vez, reunidos em um único ZIP com cada arquivo .md e suas imagens. No plano gratuito, você converte um documento por vez, com todos os ajustes disponíveis.

Continue lendo

Mais sobre Documentos →