무료 Swift 라이브러리를 통해 Markdown 파일을 Word 파일로 변환
텍스트, 표, 이미지, 리스트, 폰트 및 맞춤 형식 지원을 통해 Markdown 파일을 Word DOCX 문서로 변환하는 오픈 소스 Swift 라이브러리.
MarkdownToDocx란?
오늘날 빠르게 변화하는 개발 환경에서, 포맷 간에 콘텐츠를 원활하게 변환할 수 있는 능력은 일종의 초능력입니다. Markdown은 그 단순함 덕분에 문서, 블로그 게시물, README를 작성하는 보편적인 언어가 되었습니다. Swift 개발자에게 Markdown 파일을 Microsoft Word 형식으로 변환하는 것이 그 어느 때보다 쉬워졌습니다. MarkdownToDocx 라이브러리는 일반 텍스트 Markdown 문서를 전문가 수준으로 포맷된 DOCX 파일로 변환하는 강력하고 유연한 솔루션을 제공합니다. 이 포괄적인 가이드는 이 필수 Swift 라이브러리에 대해 알아야 할 모든 것을 탐구합니다. 기본 포맷팅을 넘어, 라이브러리는 보다 복잡한 Markdown 기능도 처리합니다. 취소선 텍스트는 적절한 포맷으로 렌더링되고, 블록 인용구는 독특한 스타일로 표시되며, 표는 헤더와 데이터 셀을 포함한 전체 구조를 보존하면서 변환됩니다.
MarkdownToDocx는 오픈소스 Swift 라이브러리로, Markdown 문서를 Microsoft Word DOCX 형식으로 원활하게 변환합니다. Apple의 MarkdownToDocx 파서와 ZIPFoundation을 활용해 아카이브를 생성하며, 이 라이브러리는 단순 텍스트 포맷팅과 전문 문서 생성 사이의 간극을 메워 줍니다. 이 라이브러리는 단순함에 뛰어나면서도 문서 스타일에 대한 세밀한 제어가 필요한 개발자를 위한 고급 맞춤 옵션을 제공합니다. 노트 작성 앱, 문서 생성기, 콘텐츠 관리 시스템을 구축하든, MarkdownToDocx는 필요한 도구를 제공합니다.
MarkdownToDocx 시작하기
MarkdownToDocx를 설치하는 권장 방법은 GitHub를 사용하는 것이며, 원활한 설치를 위해 다음 명령을 사용하십시오.
GitHub를 통해 MarkdownToDocx 설치
$ go get https://github.com/riyadshauk/markdown-docx-swift.git 프로젝트에 MarkdownToDocx를 추가하는 것은 몇 단계만 거치면 됩니다. Package.swift 파일을 열고 종속성을 추가하세요:
다음 종속성을 Dependencies 인수에 추가하세요
dependencies: [
.package(url: "https://github.com/riyadshauk/markdown-docx-swift.git", from: "1.0.0")
]
Swift를 사용하여 Markdown 파일을 DOCX로 변환하기
오픈소스 MarkdownToDocx 라이브러리는 Swift 명령을 사용하여 markdown 파일을 로드하고 Word DOCX 파일로 변환하는 지원을 포함하고 있습니다. 또한 markdown 파일을 메모리에 먼저 로드하지 않고 직접 변환할 수도 있습니다. 이 접근 방식은 전체 파일을 먼저 문자열로 로드할 필요가 없기 때문에 큰 파일에 더 효율적입니다. 아래는 Swift 명령을 사용하여 개발자가 markdown 파일을 Word DOCX 파일로 변환하는 간단한 예시입니다.
Swift 라이브러리를 사용하여 Markdown 파일을 DOCX로 변환하는 방법은?
import MarkdownToDocx
let inputURL = FileManager.default.urls(
for: .documentDirectory,
in: .userDomainMask
)[0].appendingPathComponent("input.md")
let outputURL = FileManager.default.urls(
for: .documentDirectory,
in: .userDomainMask
)[0].appendingPathComponent("output.docx")
do {
let converter = MarkdownToDocxConverter()
let docxData = try converter.convert(markdownFile: inputURL)
try docxData.write(to: outputURL)
print("File converted successfully!")
} catch {
print("Conversion error: \(error)")
}
텍스트 포맷팅 지원
MarkdownToDocx 라이브러리는 모든 필수 텍스트 포맷팅 옵션을 처리합니다. 굵게, 기울임, 취소선 포맷팅을 완전히 지원합니다. 인라인 코드 블록도 올바르게 렌더링되어 코드와 일반 텍스트를 구분하는 고정폭 포맷팅을 유지합니다. 아래의 간단한 코드 예제는 포맷된 텍스트를 변환하는 것이 얼마나 쉬운지 보여줍니다. 변환기는 Markdown 구문을 자동으로 인식하고 출력 DOCX 파일에 해당 포맷팅을 적용합니다.
Swift 라이브러리를 통해 Word DOCX에서 형식이 지정된 텍스트를 변환하는 방법은?
let markdown = """
This is **bold text** and this is *italic text*.
You can also use ~~strikethrough~~ formatting.
Here's some `inline code` in the middle of a sentence.
"""
let converter = MarkdownToDocxConverter()
let docxData = try converter.convert(markdown: markdown)
try docxData.write(to: outputURL)
Swift 라이브러리를 사용하여 중첩 Markdown 리스트 변환
오픈소스 MarkdownToDocx 라이브러리는 Swift 앱 내 Markdown 파일에서 들여쓰기된 불릿 포인트 및 번호 매기기 리스트를 처리하기 위한 완전한 지원을 제공합니다. 불릿 리스트와 번호 매기기 리스트 모두 원활하게 작동합니다. 라이브러리는 중첩 리스트를 올바르게 처리하며, 정확한 들여쓰기와 번호 매기기 방식을 유지합니다. ListStyles 설정의 들여쓰기 속성을 사용하면 중첩 항목의 위치를 조정할 수 있어 리스트가 원하는 대로 정확히 표시됩니다. 아래는 이를 수행하는 간단한 예시입니다.
Swift 라이브러리를 사용하여 중첩 Markdown 리스트를 변환하는 방법은?
let markdown = """
## Shopping List
- Fruits
- Apples
- Bananas
- Oranges
- Vegetables
- Carrots
- Broccoli
## Steps to Follow
1. First step
2. Second step
1. Sub-step one
2. Sub-step two
3. Third step
"""
let converter = MarkdownToDocxConverter()
let docxData = try converter.convert(markdown: markdown)
Swift 라이브러리로 Markdown 표 렌더링
테이블 지원은 눈에 띄는 기능 중 하나입니다. MarkdownToDocx 라이브러리는 Markdown 테이블을 정확히 해석하고 Swift 애플리케이션 내에서 적절한 테두리와 셀 포맷팅으로 렌더링합니다. 테이블은 구조를 완벽히 유지하며, 스타일링 설정을 통해 사용자 정의 가능한 테두리, 셀 패딩 및 텍스트 정렬 옵션을 제공합니다. 아래 예시는 라이브러리를 사용해 Markdown 테이블을 읽고 적절한 테두리와 셀 포맷팅으로 렌더링하는 방법을 보여줍니다.
Swift 라이브러리를 사용하여 Markdown 표를 렌더링하는 방법은?
let markdown = """
| Feature | Status | Notes |
|---------|--------|-------|
| Headings | ✅ | All levels supported |
| Lists | ✅ | Nested lists work |
| Tables | ✅ | Full support |
| Images | ✅ | Basic support |
"""
let converter = MarkdownToDocxConverter()
let docxData = try converter.convert(markdown: markdown)
Parse Markdown Documents via Swift API