Markdown-Docx: Markdown 파일을 DOCX 형식으로 변환 및 다운로드 155

markdown-docx란 무엇인가요?

markdown-docx는 Markdown 파일을 DOCX 형식으로 변환하는 데 사용되는 도구로, 브라우저와 Node.js 환경을 지원하고 고정밀 변환을 지원합니다.

markdown-docx 주요 기능

• 고정밀 변환: Markdown 파일을 높은 정확도로 DOCX 형식으로 변환할 수 있습니다.

• 이미지 지원: 변환 과정에서 이미지를 자동으로 다운로드하고 처리하는 것을 지원합니다.

• Markdown 요소 지원: 표, 목록, 코드 블록 등 다양한 Markdown 요소를 지원합니다.

• 하이퍼링크 및 각주: DOCX에서 하이퍼링크와 각주를 유지하는 것을 지원합니다.

• 스타일 사용자 정의: 사용자 정의 가능한 스타일 옵션을 제공합니다.

• 다중 환경 지원: 브라우저 환경과 Node.js 환경 모두에서 사용할 수 있습니다.

• 명령줄 인터페이스: 편리한 사용을 위한 명령줄 도구를 제공합니다.

Markdown-Docx 설치

npm, yarn, pnpm을 사용한 설치를 지원합니다:

# 사용 npm
npm install markdown-docx
# 사용 yarn
yarn add markdown-docx
# 사용 pnpm
pnpm add markdown-docx

기본 사용법

Node.js 환경

import fs from 'node:fs/promises';
import markdownDocx, { Packer } from 'markdown-docx';
async function convertMarkdownToDocx() {
  const markdown = await fs.readFile('input.md', 'utf-8');
  const doc = await markdownDocx(markdown);
  const buffer = await Packer.toBuffer(doc);
  await fs.writeFile('output.docx', buffer);
  console.log('Conversion completed successfully!');
}
convertMarkdownToDocx();

브라우저 환경

import markdownDocx, { Packer } from 'markdown-docx';

async function convertMarkdownToDocx(markdownText) {
  const doc = await markdownDocx(markdownText);
  const blob = await Packer.toBlob(doc);
  const url = URL.createObjectURL(blob);
  const a = document.createElement('a');
  a.href = url;
  a.download = 'document.docx';
  a.click();
  URL.revokeObjectURL(url);
}

document.getElementById('convert-btn').addEventListener('click', () => {
  const markdown = document.getElementById('markdown-input').value;
  convertMarkdownToDocx(markdown);
});

고급 사용법

MarkdownDocx 클래스를 사용하여 더 세밀한 제어를 할 수 있습니다:

import { MarkdownDocx, Packer } from 'markdown-docx';
import fs from 'node:fs/promises';
async function convertWithOptions() {
  const markdown = await fs.readFile('input.md', 'utf-8');
  const converter = new MarkdownDocx(markdown);
  const doc = await converter.toDocument({
    title: 'My Document',
    creator: 'markdown-docx',
    description: 'Generated from Markdown'
  });
  const buffer = await Packer.toBuffer(doc);
  await fs.writeFile('output.docx', buffer);
}

사용자 정의 구성 옵션을 지원합니다. 예:

• imageAdapter: 사용자 정의 이미지 처리 함수

• ignoreImage: Markdown의 이미지 무시

• ignoreFootnote: 각주 무시

• ignoreHtml: 인라인 HTML 무시

• gfm: GitHub Flavored Markdown 지원

명령줄 도구

전역 설치된 CLI 도구를 사용하여 파일을 변환할 수 있습니다:

# 전역 설치
npm install -g markdown-docx

# 기본 사용법
markdown-docx --input input.md --output output.docx

# 축약 형식
markdown-docx -i input.md -o output.docx

Markdown-Docx 사용 가이드

• 왼쪽 편집 영역에 Markdown 형식의 내용을 붙여넣습니다

• 오른쪽 영역에서 실시간으로 미리보기 효과를 확인합니다

• 브라우저 오른쪽 상단의 "Download Docx" 버튼을 클릭하면 팝업 창에서 문서의 기본 정보를 입력한 후 DOCX 문서를 다운로드할 수 있습니다.

Github：https://github.com/vace/markdown-docx

데모 DEMO：https://md-docx.vace.me/