Conversor de Word para Markdown

De estilos a títulos

Word para Markdown funciona melhor quando o documento usa estilos de parágrafo para expressar sua estrutura. Um parágrafo com estilo de título transmite um sinal diferente do de um texto normal que só parece grande e em negrito. Após a conversão, inspecione a sequência de títulos no código Markdown e compare com o painel de navegação do Word. Uma seção não deveria virar um novo título do documento só porque começa em uma página nova. Se a fonte depende da formatação manual, revise o resultado antes de publicá-lo em um repositório de documentação. Também é um bom momento para substituir as distinções puramente visuais por nomes de seção claros que façam sentido em texto simples.

Revisar o resultado

Revise o resultado de DOCX para Markdown no destino onde ele realmente será lido. Uma tabela pode ser Markdown válido mas larga demais para uma tela pequena, e um link pode estar correto ainda que seu rótulo dê ao leitor muito pouco contexto. Abra um documento representativo com títulos, listas aninhadas e comentários de revisão antes de migrar uma coleção inteira. Compare o conteúdo posterior à última tabela e também o início do arquivo, porque as conclusões importantes costumam ficar perto do fim. Guarde o DOCX de origem junto do Markdown exportado para que os editores possam investigar uma diferença sem adivinhar qual versão produziu o resultado. Uma conversão é um artefato de partida para a publicação, não uma aprovação editorial automática.

Comentários e revisões

Word para Markdown exporta o documento legível e reúne como texto os comentários de revisão de DOCX que ele aceita. Uma seção de comentários é útil para conservar os comentários recebidos, mas não recria a interface de revisão do Word. Não presuma que um comentário exportado continue colado ao intervalo exato de caracteres que ele anotava. As decisões de revisão que dependiam de uma âncora em linha ainda precisam do documento original. Do mesmo modo, Markdown não é um formato de controle de alterações: os leitores não devem esperar aceitar ou rejeitar revisões dentro do arquivo exportado. Resolva o texto em disputa na fonte antes de publicar uma versão final e depois confirme que os parágrafos exportados contêm o texto aceito pretendido.

Word versus PDF

Use Word para Markdown quando o documento do Word editável for sua fonte da verdade e o próximo passo for editar, controlar versões ou reutilizar em um fluxo de trabalho de texto. Converter primeiro o mesmo documento para PDF pode transformar sua útil estrutura de parágrafos em um layout de página que depois precisa ser reinterpretado. A conversão para PDF é adequada quando o PDF é a única versão autorizada de que você dispõe, como um relatório assinado ou publicado. Para uma migração de documentação, comece pela fonte do Word quando você a tiver, mantenha as imagens e as referências sob revisão e compare o Markdown final no renderizador de destino. Escolha a rota pela fonte de que você dispõe, não só pelo nome de arquivo que você quer obter no fim.

Fluxos de trabalho de documentos

Documentos editoriais incluem alterações controladas e balões de revisão que somem ao colar como texto simples. Este conversor exporta a visão aceita e reúne os comentários sob um título próprio para que quem escreve continue vendo o fio de revisão.

• Os estilos Título 1–6 são mapeados para os níveis # do Markdown.
• O texto inserido é preservado; o texto excluído é omitido.
• As âncoras de comentários em linha não são preservadas: só o texto do comentário sob ## Comments.