O que é WordToMD?

Nossa Missão

O WordToMD existe para resolver um problema específico e comum: obter conteúdo de documentos do Word para o Markdown sem trabalho de formatação manual. Seja você um desenvolvedor a escrever documentação, um escritor a manter um blog, ou uma organização migrando uma base de conhecimento o passo de conversão Word-para-Markdown não deve ser doloroso.

Como funciona

WordToMD é alimentado por duas excelentes bibliotecas de código aberto:

• mammoth.js Leia arquivos .docx no navegador através da API FileReader e converte-os em HTML limpo, mapeando estilos Word (Heading 1, Heading 2, etc.) aos seus equivalentes HTML.
• turndown Converte a saída HTML de mammoth em Markdown padrão, com regras personalizadas para tabelas (GitHub Flavored Markdown), blocos de código, e outros elementos.

O pipeline inteiro corre dentro da guia do navegador. O ficheiro é lido usando o FileReader API, nunca transmitido pela rede.

Privacidade em primeiro lugar

Muitas ferramentas de conversão de documentos exigem que você carregue seu arquivo para um servidor. Isso significa que o seu conteúdo, relatórios potencialmente confidenciais, documentos de clientes, artigos de base de conhecimento interna passa pela infra-estrutura de outra pessoa.

WordToMD é arquitetonicamente diferente: a lógica de conversão é executada em JavaScript na guia do seu navegador. Os bytes de arquivo nunca saem do seu dispositivo. Você pode verificar isso abrindo a guia Rede (F12) do seu navegador antes de converter você verá zero solicitações de upload de arquivos.

O que é preservado

Os seguintes elementos Word são convertidos de forma fiável:

• Títulos (H1H6) → Títulos de tipo ATX Markdown
• Em negrito (**texto**) e em itálico (_texto_) formatação
• Listas ordenadas e não ordenadas, incluindo listas aninhadas
• Tabelas → GitHub Aromatizadas Markdown sintaxe da tabela
• Hiperlinks com texto de âncora
• Monospaço / texto codificado
• Todos os caracteres Unicode (chinês, japonês, árabe, emoji, etc.)

Limitações conhecidas

Alguns recursos Word não têm equivalentes Markdown:

• As células da tabela combinada são simplificadas para colunas adjacentes
• As imagens incorporadas são exportadas para uma pasta de imagens quando você escolhe o Markdown + imagens ZIP download
• Caixas de texto e SmartArt não são suportados
• Mapear estilos de parágrafo personalizados para o equivalente padrão mais próximo
• Mudanças / comentários da faixa são removidos (somente o conteúdo final é convertido)

Quando o mamute detecta elementos que não pode converter completamente, O painel "Notas de conversão" na vista de resultados irá listá-los para que possa rever manualmente.