Converter DOCX para Markdown
Tirar a documentação do Word e levá-la para um repositório Git começa por transformar cada .docx em Markdown. Este conversor gera texto no estilo CommonMark com títulos #, tabelas com barras verticais e links de imagem, pronto para commit.
Conversor de documentos
ou solte arquivos PDF, DOC, DOCX … aqui ·
Até 95 MB por arquivo· Até 20 arquivos· Apagados após 30 minutos
Os arquivos são processados em nossos servidores e apagados após 30 minutos.
150 DPI transforma uma página A4 em cerca de 1240 × 1754 px. Use 300 para impressão.
Converta o arquivo inteiro ou só algumas páginas ou slides (entrada PDF e apresentações).
Páginas ou slides a converter, por exemplo 1-3, 5, 8-10.
UTF-8 funciona para qualquer idioma. Escolha UTF-8 com BOM se o Excel ou o Bloco de Notas no Windows mostrar caracteres embaralhados; codificações antigas só para programas antigos.
LF para macOS, Linux e editores de código; CRLF para programas antigos do Windows, como o Bloco de Notas clássico.
Vírgula é o padrão. Use ponto e vírgula para o Excel em países que escrevem decimais com vírgula (Alemanha, França, Brasil).
Entrada Excel com várias planilhas: converta todas (uma seção ou arquivo por planilha) ou só a primeira.
Como usar esta ferramenta
- 1
Envie os arquivos do Word
Adicione até 20 arquivos .docx ou .doc, com até 95 MB cada. Aceite ou rejeite as alterações controladas no Word antes, porque o Markdown não tem como mostrá-las.
- 2
Confira as opções de texto
Formatação vem em Simples, Codificação do texto em UTF-8 e Quebras de linha em LF, a combinação que o Git e os geradores de sites estáticos esperam. Mantenha Incluir imagens ativado para receber as figuras em uma pasta.
- 3
Converta e descompacte
Clique em Converter para MD. Cada documento chega como um ZIP com o arquivo .md e as imagens dele; descompacte na sua pasta de documentação e faça o commit.
Como converter um documento do Word em Markdown?
Envie o .docx e clique em Converter para MD. Você recebe um arquivo .md com títulos #, listas, links e tabelas, mais as imagens em uma pasta ao lado, tudo dentro de um ZIP.
DOCX para Markdown em docs-as-code
As equipes adotam docs-as-code por um motivo: a documentação passa a ficar ao lado do código, segue pelos mesmos pull requests e sai na mesma versão. Um .docx quebra isso, porque é um ZIP de partes XML que o Git guarda como um binário opaco. Uma mudança de uma palavra aparece como um arquivo alterado sem diff legível, e duas pessoas editando ao mesmo tempo não conseguem mesclar o trabalho.
Markdown é texto puro, então cada edição é uma mudança de linha visível. Ele também ficou bem mais previsível em 2014, quando John MacFarlane e outros publicaram o CommonMark, uma especificação precisa da sintaxe que Gruber tinha descrito de forma solta dez anos antes. Em 2017 o GitHub baseou no CommonMark sua própria especificação, o GitHub Flavored Markdown, acrescentando as tabelas com barras verticais, as listas de tarefas e o tachado que a maioria dos READMEs usa hoje.
Se o seu conteúdo vai no sentido contrário, do Markdown para um revisor que trabalha no Word, use Markdown para DOCX. Para uma página da web em vez de um repositório, DOCX para HTML preserva mais da formatação.
Como fica a saída em Markdown
## Checklist de lançamento Antes de criar a tag de uma versão, confirme o seguinte: - Os testes passam na **main** - O changelog lista todos os PRs mesclados | Etapa | Responsável | | --- | --- | | Build | CI | | Publicação | Mantenedor | 
Onde o Markdown convertido vai ser exibido
| Órgão | Exigência | Fonte |
|---|---|---|
| GitHub | Exibe o README.md e qualquer arquivo .md de um repositório usando o GitHub Flavored Markdown | github.com |
| Hugo | Gera páginas a partir de arquivos de conteúdo .md com um parser compatível com CommonMark | gohugo.io |
| Jekyll | Transforma arquivos .md com front matter em páginas; é o motor por trás do GitHub Pages | jekyllrb.com |
| Docusaurus | Lê arquivos .md e .mdx da pasta docs como páginas de documentação | docusaurus.io |
DOCX
Documento do Microsoft Word
DOCX é o formato de documento padrão do Microsoft Word desde o Office 2007, baseado no padrão Office Open XML (ECMA-376, ISO/IEC 29500). É um pacote ZIP de arquivos XML com texto, estilos, imagens, tabelas, comentários e alterações controladas. É o formato mais comum para documentos editáveis em empresas, escolas e candidaturas a vagas. O layout pode mudar um pouco entre Word, Google Docs, LibreOffice e Pages, principalmente com formatação complexa. A maioria dos processadores de texto abre arquivos DOCX.
- Compressão
- –
- Transparência
- –
- Animação
- –
- Lançamento
- 2007 · Microsoft
MD
Markdown
Markdown é uma sintaxe de marcação leve criada por John Gruber em 2004. Ela usa símbolos de texto simples, como # para títulos, * para ênfase e - para listas, que continuam legíveis como texto bruto e se convertem de forma limpa em HTML. É o padrão em arquivos README, documentação, wikis, aplicativos de notas e muitos geradores de sites estáticos. Existem vários dialetos, como CommonMark e GitHub Flavored Markdown, que diferem em detalhes como tabelas. Qualquer editor de texto abre arquivos .md.
- Compressão
- –
- Transparência
- –
- Animação
- –
- Lançamento
- 2004 · John Gruber
O DOCX é convertido em Markdown quando um documento entra em um fluxo de código: um README, um site de documentação ou uma base de conhecimento mantida no Git, onde o texto puro pode ser comparado, revisado em pull requests e exibido por várias ferramentas.
Recursos do Word sem equivalente em Markdown
Planeje estes pontos antes de converter
- Fontes, cores e layout de página são descartados; o Markdown descreve a estrutura, e o tema do site decide a aparência
- Alterações controladas e comentários não são levados, então resolva-os no Word antes
- Cabeçalhos, rodapés e números de página não têm lugar em um arquivo .md
- Caixas de texto e imagens com quebra automática viram parágrafos comuns e links de imagem
- Títulos formatados à mão, em negrito 16 pt em vez de Título 2, saem como texto em negrito, então aplique estilos de título de verdade antes
- O sublinhado não tem sintaxe em Markdown e é removido ou mantido como HTML
Perguntas sobre converter DOCX para Markdown
Qual sabor de Markdown a saída de DOCX para MD segue?
Títulos, ênfase, listas, links e código seguem o CommonMark, e as tabelas usam a sintaxe com barras verticais do GitHub Flavored Markdown. GitHub, GitLab, Hugo, Jekyll e Docusaurus exibem essa combinação.
O que acontece com células de tabela mescladas ao converter para Markdown?
Tabelas Markdown com barras verticais não têm células mescladas, então cada área mesclada é dividida de novo em células individuais, com o texto na primeira. Refaça tabelas complexas em HTML dentro do .md ou simplifique-as no Word antes de converter.
Para onde vão as imagens do meu documento do Word?
Com Incluir imagens ativado, cada imagem é salva como um arquivo separado no ZIP, e o Markdown aponta para ela com um caminho relativo como images/figure-1.png. Mantenha a pasta ao lado do arquivo .md quando for movê-lo.
As notas de rodapé do Word sobrevivem no Markdown?
O CommonMark não tem sintaxe de nota de rodapé, mas o GitHub adicionou as notas [^1] em 2021 e a maioria dos geradores de sites aceita. Se o seu renderizador não aceitar, o texto da nota aparece como parágrafos comuns no fim.
Posso converter Google Docs em Markdown assim?
Sim. No Google Docs, escolha Arquivo > Fazer o download > Microsoft Word (.docx) e envie esse arquivo aqui. O Google Docs também tem uma opção própria de download em Markdown, que funciona bem para documentos simples.
