Repolode
Enviar
mwilliamson

mwilliamson/mammoth.js

Biblioteca JavaScript e CLI que converte documentos Word .docx em HTML semântico e limpo.

Ver no GitHub
Estrelas
6,330
Forks
673
Issues abertas
60
Último commit
há 5 dias

O que é?

Mammoth converte arquivos .docx, como os criados no Microsoft Word, Google Docs e LibreOffice, em HTML. Ele usa as informações semânticas do documento, como os estilos de parágrafo, e ignora a maior parte da formatação visual. Assim, um parágrafo com o estilo Heading 1 vira um elemento h1, em vez de reproduzir a fonte e o tamanho usados no documento.

Ele funciona no Node.js e no navegador e pode ser usado por meio de uma API de biblioteca ou de uma ferramenta de linha de comando. Com mapas de estilo personalizados, você pode associar seus próprios estilos do Word a elementos e classes HTML; um hook de transformação do documento permite modificá-lo após a análise e antes da geração do HTML. As imagens podem ser incorporadas como data URIs ou gravadas em um diretório de saída separado.

Como a saída não é sanitizada, é preciso ter cuidado ao lidar com entradas não confiáveis. O acesso a arquivos externos vem desativado por padrão. As versões para Python, Java/JVM e .NET são mantidas como projetos separados.

Recursos principais

  • 01Converte títulos, listas, tabelas, imagens, links, notas de rodapé e notas de fim para HTML.
  • 02Associa estilos personalizados do Word a elementos HTML por meio de mapas de estilo.
  • 03Oferece suporte a negrito, itálico, sublinhado, tachado, sobrescrito e subscrito.
  • 04Disponibiliza uma CLI e uma API de biblioteca para Node.js e navegador.
  • 05Extrai o texto bruto dos documentos, ignorando a formatação.
  • 06Permite transformar documentos antes da geração do HTML.

Casos de uso

  • Importar artigos ou documentação criados no Word para um site ou CMS.
  • Visualizar conteúdo .docx no navegador sem precisar instalar o Word.
  • Converter arquivos Word em lote para HTML em um pipeline de build ou servidor com Node.js.

Início rápido

  1. 1

    Instale a biblioteca pelo npm

    npm install mammoth
  2. 2

    Converta um arquivo .docx para HTML com a CLI

    mammoth document.docx output.html

Antes de usar

  • O Mammoth não sanitiza os documentos de origem, então é preciso ter cuidado com entradas não confiáveis.
  • É pouco provável que a conversão de documentos complexos seja perfeita, pois as estruturas de .docx e HTML são diferentes.
  • A saída em Markdown foi descontinuada.

Tópicos

#docx#word#html-conversion#nodejs#javascript#document-processing

Perguntas frequentes

O que é mammoth.js?
Biblioteca JavaScript e CLI que converte documentos Word .docx em HTML semântico e limpo. Mammoth converte arquivos .docx, como os criados no Microsoft Word, Google Docs e LibreOffice, em HTML. Ele usa as informações semânticas do documento, como os estilos de parágrafo, e ignora a maior parte da formatação visual. Assim, um parágrafo com o estilo Heading 1 vira um elemento h1, em vez de reproduzir a fonte e o tamanho usados no documento.
mammoth.js é gratuito? Qual é a licença?
mammoth.js é open source sob a licença BSD-2-Clause. Confira os termos da licença antes de usá-lo em produtos comerciais.
mammoth.js ainda é mantido?
Manutenção ativa. O último commit de mammoth.js foi em 16 de out. de 2026.
Para que posso usar mammoth.js?
Importar artigos ou documentação criados no Word para um site ou CMS. Visualizar conteúdo .docx no navegador sem precisar instalar o Word. Converter arquivos Word em lote para HTML em um pipeline de build ou servidor com Node.js.
Como instalar mammoth.js?
Instale a biblioteca pelo npm: npm install mammoth Converta um arquivo .docx para HTML com a CLI: mammoth document.docx output.html
Onde consigo mammoth.js?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/mwilliamson/mammoth.js

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados