Word para Markdown Guia de formatação: Preservar todos os estilos

A formatação é onde a maioria das conversões Word-para-Markdown dá errado. O texto em negrito é exibido como texto simples. As mesas desmoronam. Os cabeçalhos tornam-se parágrafos sem estilo. Este guia explica exactamente o que acontece durante Word para Markdown O sistema de controlo da produção é o mais eficaz possível.

Compreender o processo de conversão

Quando você converte um documento Word para Markdown, duas coisas acontecem:

1. DOCX → HTML mammoth.js analisa o Word XML e mapeia cada elemento para HTML
2. HTML → Markdown Turndown converte a sintaxe HTML para Markdown

O segundo passo é sem perdas se o HTML estiver limpo. O primeiro passo é onde a complexidade de formatação importa Words estilos precisam mapear para equivalentes HTML conhecidos.

Utilização Convertidor de WordToMDs para ver exatamente como o seu documento converte em tempo real.

Estilos de cabeçalho

A decisão de formatação mais importante em Word é usar estilos de cabeçalho incorporados.

Erro comum: Formatear manualmente o texto como grande e em negrito em vez de aplicar um estilo de cabeçalho. Isto parece um cabeçalho em Word mas converte para texto em negrito em Markdown, não ##.

Para a referência completa das posições, ver Markdown Guia de cabeçalhos.

Enfatização do texto

Sublinhar e destacar não têm equivalente Markdown na sintaxe padrão. Após a conversão, utilizar HTML <u> tags ou classes CSS personalizadas, se a sua plataforma de publicação as suportar.

Listas

Word's automática lista de formatação converte limpo:

- Bullet item one
- Bullet item two
  - Nested bullet (indent 2 spaces)

1. First item
2. Second item
   1. Nested numbered item

O que quebra as listas: Traços ou números digitados manualmente que não sejam itens de lista Word reais. Estes parecem listas visualmente, mas Word trata-os como parágrafos de texto simples. A correção: selecione-os em Word e aplique o estilo Lista Bullet ou Lista Número.

Tabelas

Tabelas padrão convertidas para GitHub Aromatizado Markdown sintaxe da tabela:

| Column 1 | Column 2 | Column 3 |
|---|---|---|
| Cell A | Cell B | Cell C |
| Cell D | Cell E | Cell F |

O que quebra as mesas:

• Células unificadas a célula que abrange várias colunas ou linhas será colapsada
• Conteúdo de células de várias linhas As quebras de linhas no interior das células são retiradas
• Tabelas aninhadas A tabela interna é aplanada para texto simples

Para uma desagregação completa, ver Markdown Tabelas: um guia completo.

Código e texto pré-formateado

Texto formatado com uma fonte monospacial (Courier New, Consolas) em mapas Word para código em linha:

Use `console.log()` to debug.

Para blocos de código cercados com destaque de sintaxe, aplique Words Code estilo de parágrafo se o seu modelo tiver um, ou adicionar manualmente a vedação com o triplo backtick após a conversão. A seguir: Markdown Guia de blocos de código para a sintaxe completa.

Hiperligações

Word hiperlinks convertem perfeitamente:

Visit [WordToMD](https://wordtomd.org) for instant conversion.

O texto da ligação e a URL são preservados. Os marcadores (links internos dentro do mesmo documento) podem não ser convertidos se o alvo não existir em Markdown.

Imagens

Imagens são onde a conversão de Word para Markdown sempre fica aquém. mammoth.js pode extrair imagens incorporadas como base64 dados URIs, mas o comportamento padrão é notar a sua presença em notas de conversão. Após a conversão:

1. Exportar imagens de Word: Arquivo → Salvar como → Página Web (HTML)
2. Refere-se a eles em Markdown: ![Alt text](path/to/image.png)

Caracteres e símbolos especiais

Word geralmente insere caracteres especiais do Unicode automaticamente:

• Cotações inteligentes ("...") → preservado como caracteres Unicode
• Em dash (—) → conservado
• Espaços não-quebrantes → convertidos em espaços regulares
• Símbolo de direitos autorais (©) → conservado

Se você precisar de somente ASCII saída, fazer um encontrar-e-substituir no seu editor de texto após a conversão.

Estilos Word personalizados

Se o seu documento Word usa estilos de parágrafo personalizados (como Callout ou Warning), mammoth.js registra-os como notas de conversão. Você verá mensagens como Estilo de parágrafo não reconhecido: Callout. WordToMD filtra essas mensagens informativas por padrão.

Para lidar com estilos personalizados, você precisa de uma configuração local Pandoc com um filtro personalizado Pandoc Word para Markdown para essa abordagem.

Lista de verificação de formatação antes de converter

Aplique esta lista de verificação ao seu documento Word antes de converter:

• Todas as rubricas utilizam Words embutidos nos estilos 1/2/3 de rubricas (não formatação manual)
• Listas são criadas com ferramentas de lista Words (não digitadas com traços/números)
• As tabelas são grelhas simples (sem células fundidas)
• Código usa uma fonte monospaço
• Os hiperlinks são hiperlinks reais (não apenas texto sublinhado em azul)

FAQ

Por que os meus títulos estão a converter-se em texto em negrito? Aplicou o formato manual em negrito + tamanho de fonte em vez do estilo de cabeçalho. Em Word, clique no parágrafo e veja o painel Estilos deve dizer Título 1 não Normal.

Minha lista numerada reiniciou em 1 no lugar errado como eu corrigi? Configurar a continuação da lista em Word: clique com o botão direito na lista → Continuar a Numeração. Ou editar o Markdown diretamente após a conversão.

O alinhamento da tabela parece errado em Markdown. - O que aconteceu? - O que aconteceu? GFM tabela de utilização |---| para separadores de alinhamento. WordToMD gera estes automaticamente. Se a reprodução não parecer adequada, verifique se nenhuma célula contém caracteres de tubo (|) no seu conteúdo escapa-lhes como \|.

Conclusão

A limpar-me . Word para Markdown formatação é principalmente sobre usar Word corretamente. Aplicar estilos de cabeçalho embutidos, usar Words lista e ferramentas de tabela, e você vai obter saída quase perfeita a partir do Conversor WordToMD. For edge cases — custom styles, complex tables, images — the tips above will get you the rest of the way there.