mwilliamson/mammoth.js

어떤 프로젝트인가요?

핵심 기능

• 01제목, 목록, 표, 이미지, 링크, 각주 및 미주를 HTML로 변환합니다.
• 02스타일 맵을 사용해 사용자 지정 Word 스타일을 HTML 요소에 매핑합니다.
• 03굵게, 기울임꼴, 밑줄, 취소선, 위 첨자 및 아래 첨자를 지원합니다.
• 04CLI와 Node.js/브라우저용 라이브러리 API를 제공합니다.
• 05서식을 무시하고 문서에서 일반 텍스트를 추출합니다.
• 06HTML 생성 전에 문서 변환을 적용할 수 있습니다.

활용 사례

• Word로 작성한 글이나 문서를 웹사이트 또는 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로 변환합니다. 문단 스타일 같은 문서의 의미 정보를 활용하고 대부분의 시각적 서식은 무시하므로, Heading 1 스타일이 적용된 문단은 글꼴과 크기를 그대로 복제하는 대신 h1 요소로 변환됩니다.

mammoth.js은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

mammoth.js은(는) BSD-2-Clause 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

mammoth.js은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. mammoth.js의 마지막 커밋은 2026년 10월 16일입니다.

mammoth.js은(는) 어디에 사용할 수 있나요?

Word로 작성한 글이나 문서를 웹사이트 또는 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