تبدیل فایل‌های Markdown به فایل‌های Word از طریق کتابخانه رایگان Swift

شروع کار با MarkdownToDocx

روش پیشنهادی برای نصب MarkdownToDocx استفاده از GitHub است؛ لطفاً برای نصب بدون مشکل از دستور زیر استفاده کنید.

$ go get https://github.com/riyadshauk/markdown-docx-swift.git   

dependencies: [
    .package(url: "https://github.com/riyadshauk/markdown-docx-swift.git", from: "1.0.0")
]

تبدیل فایل‌های Markdown به DOCX با استفاده از Swift

کتابخانه منبع باز MarkdownToDocx پشتیبانی از بارگذاری و تبدیل فایل‌های markdown به فایل‌های Word DOCX را با استفاده از دستورات Swift فراهم کرده است. همچنین می‌توانید فایل‌های Markdown را مستقیماً بدون بارگذاری اولیه در حافظه تبدیل کنید. این روش برای فایل‌های بزرگ کارآمدتر است زیرا نیازی به بارگذاری کل فایل به عنوان رشته ابتدا ندارد. در اینجا یک مثال ساده آورده شده است که نشان می‌دهد توسعه‌دهندگان نرم‌افزار چگونه می‌توانند یک فایل markdown را به فایل Word DOCX با استفاده از دستورات Swift تبدیل کنند.

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 تمام گزینه‌های اساسی قالب‌بندی متن را مدیریت می‌کند. متن بولد، ایتالیک و خط‌خورده به‌طور کامل پشتیبانی می‌شوند. بلوک‌های کد درون‌خطی نیز به‌درستی رندر می‌شوند و قالب‌بندی monospace را که کد را از متن عادی متمایز می‌کند، حفظ می‌کنند. مثال ساده کد زیر نشان می‌دهد تبدیل متن قالب‌بندی‌شده چقدر آسان است. مبدل به‌طور خودکار سینتکس Markdown را تشخیص داده و قالب‌بندی مربوطه را در فایل 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)

تبدیل فهرست‌های تو در توی Markdown با کتابخانه Swift

کتابخانه منبع باز MarkdownToDocx پشتیبانی کامل برای مدیریت فهرست‌های نقطه‌دار و عددی با تورفتگی در فایل‌های Markdown داخل برنامه‌های Swift فراهم کرده است. هر دو نوع فهرست—نقطه‌دار و عددی—به‌صورت یکپارچه کار می‌کنند. این کتابخانه فهرست‌های تو در تو را به‌درستی پردازش می‌کند و تورفتگی و الگوهای شماره‌گذاری صحیح را حفظ می‌کند. ویژگی تورفتگی در پیکربندی ListStyles به شما امکان می‌دهد موقعیت آیتم‌های تو در تو را تنظیم کنید تا فهرست‌های شما دقیقاً به شکلی که می‌خواهید ظاهر شوند. در اینجا یک مثال ساده آورده شده که نشان می‌دهد چگونه این کار را انجام دهید.

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)

نمایش جدول‌های Markdown با کتابخانه Swift

پشتیبانی از جدول‌ها یکی از ویژگی‌های برجسته است. کتابخانه MarkdownToDocx به‌درستی جداول 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