mwilliamson/mammoth.js

これは何？

主な機能

• 01見出し、リスト、表、画像、リンク、脚注、巻末注をHTMLに変換します。
• 02スタイルマップを使って、独自のWordスタイルをHTML要素に対応付けます。
• 03太字、斜体、下線、取り消し線、上付き文字、下付き文字に対応しています。
• 04CLIと、Node.jsおよびブラウザー向けのライブラリAPIを提供します。
• 05書式を無視して、文書からプレーンテキストを抽出します。
• 06HTML生成前に文書を変換できます。

ユースケース

• Wordで作成した記事やドキュメントを、WebサイトやCMSに取り込む。
• Wordをインストールせずに、ブラウザーで.docxの内容をプレビューする。
• Node.jsのビルドやサーバーのパイプラインで、Wordファイルを一括してHTMLに変換する。

クイックスタート

1. 1

   npmからライブラリをインストールする

   npm install mammoth
2. 2

   CLIで.docxファイルをHTMLに変換する

   mammoth document.docx output.html

使う前に知っておきたいこと

• !Mammothは元のドキュメントをサニタイズしないため、信頼できない入力を扱う際は注意が必要です。
• !.docxとHTMLでは構造が異なるため、複雑なドキュメントは完全には変換できない可能性があります。
• !Markdown形式での出力は非推奨です。

トピック

よくある質問

mammoth.js とは？

.docx形式のWord文書を、クリーンでセマンティックなHTMLに変換するJavaScriptライブラリおよびCLI。 Mammothは、Microsoft Word、Google Docs、LibreOfficeなどで作成された.docxファイルをHTMLに変換します。段落スタイルなど、文書のセマンティックな情報を利用し、見た目の書式設定の大部分は無視します。そのため、「見出し 1」スタイルの段落は、フォントやサイズを再現するのではなく、h1要素になります。

mammoth.js は無料で使えますか？ライセンスは？

mammoth.js は BSD-2-Clause ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

mammoth.js は今もメンテナンスされていますか？

活発にメンテナンス中。mammoth.js の最終コミットは 2026年10月16日 です。

mammoth.js は何に使えますか？

Wordで作成した記事やドキュメントを、WebサイトやCMSに取り込む。 Wordをインストールせずに、ブラウザーで.docxの内容をプレビューする。 Node.jsのビルドやサーバーのパイプラインで、Wordファイルを一括してHTMLに変換する。

mammoth.js のインストール方法は？

npmからライブラリをインストールする: npm install mammoth CLIで.docxファイルをHTMLに変換する: mammoth document.docx output.html

mammoth.js はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/mwilliamson/mammoth.js