Repolode
Enviar
mwilliamson

mwilliamson/mammoth.js

Biblioteca de JavaScript y CLI que convierte documentos Word .docx en HTML limpio y semántico.

Ver en GitHub
Estrellas
6,330
Forks
673
Issues abiertos
60
Último commit
hace 5 días

¿Qué es?

Mammoth convierte archivos .docx, como los creados con Microsoft Word, Google Docs y LibreOffice, en HTML. Se basa en la información semántica del documento, como los estilos de párrafo, e ignora la mayor parte del formato visual. Así, un párrafo con el estilo Heading 1 se convierte en un elemento h1, en lugar de imitar la fuente y el tamaño.

Se ejecuta en Node.js y en el navegador, y se puede usar mediante una API de biblioteca o una herramienta de línea de comandos. Los mapas de estilos personalizados permiten asignar tus propios estilos de Word a elementos y clases HTML, y un hook de transformación del documento permite modificar el documento analizado antes de generar el HTML. Las imágenes se pueden incrustar como data URIs o guardar en un directorio de salida independiente.

Como la salida no se sanitiza, hay que tratar con cuidado las entradas que no sean de confianza. El acceso a archivos externos está desactivado de forma predeterminada. Las implementaciones para Python, Java/JVM y .NET se mantienen como proyectos independientes.

Funciones clave

  • 01Convierte encabezados, listas, tablas, imágenes, enlaces, notas al pie y notas al final en HTML.
  • 02Asigna estilos de Word personalizados a elementos HTML mediante mapas de estilos.
  • 03Admite negrita, cursiva, subrayado, tachado, superíndice y subíndice.
  • 04Ofrece una CLI y una API de biblioteca para Node.js y el navegador.
  • 05Extrae texto sin formato de los documentos e ignora el formato.
  • 06Permite transformar documentos antes de generar el HTML.

Casos de uso

  • Importar artículos o documentación creados en Word a un sitio web o CMS.
  • Previsualizar contenido .docx en un navegador sin tener Word instalado.
  • Convertir archivos Word por lotes a HTML en un proceso de compilación o canalización de servidor con Node.js.

Inicio rápido

  1. 1

    Instala la biblioteca desde npm

    npm install mammoth
  2. 2

    Convierte un archivo .docx a HTML con la CLI

    mammoth document.docx output.html

Antes de usarlo

  • Mammoth no sanea los documentos de origen, así que hay que tener cuidado con las entradas que no sean de confianza.
  • Es poco probable que la conversión de documentos complejos sea perfecta, ya que las estructuras de .docx y HTML son diferentes.
  • La salida en Markdown está obsoleta.

Temas

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

Preguntas frecuentes

¿Qué es mammoth.js?
Biblioteca de JavaScript y CLI que convierte documentos Word .docx en HTML limpio y semántico. Mammoth convierte archivos .docx, como los creados con Microsoft Word, Google Docs y LibreOffice, en HTML. Se basa en la información semántica del documento, como los estilos de párrafo, e ignora la mayor parte del formato visual. Así, un párrafo con el estilo Heading 1 se convierte en un elemento h1, en lugar de imitar la fuente y el tamaño.
¿mammoth.js es gratuito? ¿Qué licencia tiene?
mammoth.js es open source bajo la licencia BSD-2-Clause. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿mammoth.js sigue mantenido?
Mantenimiento activo. El último commit de mammoth.js fue el 16 oct 2026.
¿Para qué puedo usar mammoth.js?
Importar artículos o documentación creados en Word a un sitio web o CMS. Previsualizar contenido .docx en un navegador sin tener Word instalado. Convertir archivos Word por lotes a HTML en un proceso de compilación o canalización de servidor con Node.js.
¿Cómo se instala mammoth.js?
Instala la biblioteca desde npm: npm install mammoth Convierte un archivo .docx a HTML con la CLI: mammoth document.docx output.html
¿Dónde consigo mammoth.js?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/mwilliamson/mammoth.js

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados