HWP-MD Converter

주요 기능

지원하는 Markdown 요소

요구 사항

설치

Maven

<repositories>
 <repository>
 <id>manty-releases</id>
 <url>https://nexus.manty.co.kr/repository/maven-releases/</url>
 </repository>
</repositories>

<dependency>
 <groupId>kr.co.manty</groupId>
 <artifactId>hwp-markdown-converter</artifactId>
 <version>0.9.0</version>
</dependency>

사용법

1. 간단한 변환 (Quick API)

Markdown → HWP

import kr.co.manty.docconv.api.DocConv;
import kr.co.manty.docconv.core.converter.ConversionResult;
import java.nio.file.Path;
String markdown = """
 # 제목

 이것은 **굵은 글씨**와 *기울임 글씨* 예제입니다.

 ## 목록

 - 항목 1
 - 항목 2
 - 항목 3

 ## 테이블

 | 이름 | 나이 |
 |------|------|
 | 홍길동 | 30 |
 | 김철수 | 25 |
 """;
ConversionResult<Path> result = DocConv.markdownToHwp(markdown, Path.of("output.hwp"));
if (result.isSuccess()) {
 System.out.println("변환 성공: " + result.getResult());
} else {
 System.out.println("변환 실패: " + result.getErrorMessage());
}

Markdown → HWPX

ConversionResult<Path> result = DocConv.markdownToHwpx(markdown, Path.of("output.hwpx"));

HWP → Markdown

ConversionResult<String> result = DocConv.hwpToMarkdown(Path.of("input.hwp"));
if (result.isSuccess()) {
 String markdown = result.getResult();
 System.out.println(markdown);
}

HWPX → Markdown

ConversionResult<String> result = DocConv.hwpxToMarkdown(Path.of("input.hwpx"));

HWP → HWPX

ConversionResult<Path> result = DocConv.hwpToHwpx(
 Path.of("input.hwp"),
 Path.of("output.hwpx")
);

HWPX → HWP

ConversionResult<Path> result = DocConv.hwpxToHwp(
 Path.of("input.hwpx"),
 Path.of("output.hwp")
);

파일에서 파일로 직접 변환

// Markdown 파일 → HWP 파일
ConversionResult<Path> result = DocConv.markdownFileToHwp(
 Path.of("input.md"),
 Path.of("output.hwp")
);
// HWP 파일 → Markdown 파일
ConversionResult<Path> result = DocConv.hwpToMarkdownFile(
 Path.of("input.hwp"),
 Path.of("output.md")
);

2. Builder API

import kr.co.manty.docconv.api.DocConv;
// Markdown → HWP (Builder 사용)
ConversionResult<Path> result = DocConv.convert()
 .fromMarkdown(markdown)
 .tableMergeStrategy(DocConv.TableMergeStrategy.FLATTEN)
 .toHwp(Path.of("output.hwp"));
// HWP → Markdown (Builder 사용)
ConversionResult<String> result = DocConv.convert()
 .fromHwp(Path.of("input.hwp"))
 .toMarkdown();
// HWPX → HWP (Builder 사용)
ConversionResult<Path> result = DocConv.convert()
 .fromHwpx(Path.of("input.hwpx"))
 .toHwp(Path.of("output.hwp"));
// InputStream에서 읽기
try (InputStream is = new FileInputStream("input.hwp")) {
 ConversionResult<String> result = DocConv.convert()
 .fromHwp(is)
 .toMarkdown();
}

3. MarkdownHwpRenderer 직접 사용

import kr.co.manty.hwp.renderer.MarkdownHwpRenderer;
import java.nio.file.Paths;
MarkdownHwpRenderer renderer = new MarkdownHwpRenderer();
renderer.renderMarkdown("# Hello World\n\nThis is **bold** text.");
renderer.saveToFile(Paths.get("output.hwp"));

4. 변환 결과 처리

ConversionResult<Path> result = DocConv.markdownToHwp(markdown, outputPath);
// 성공 여부 확인
if (result.isSuccess()) {
 Path outputFile = result.getResult();
 System.out.println("파일 생성됨: " + outputFile);
 // 경고 확인
 if (result.hasWarnings()) {
 System.out.println("경고:");
 result.getWarnings().forEach(warning ->
 System.out.println(" - " + warning.type() + ": " + warning.message())
 );
 }
} else {
 System.out.println("오류: " + result.getErrorMessage());
}
// 또는 예외를 던지도록 처리
Path outputFile = result.getResultOrThrow(); // 실패 시 ConversionException 발생

API 참조

DocConv 클래스

ConversionBuilder 클래스

TableMergeStrategy 열거형

제한 사항

의존성

라이선스

기여