Перетворення Markdown файлів у Word файли за допомогою безкоштовної Swift бібліотеки

Бібліотека Swift з відкритим кодом для перетворення Markdown файлів у Word DOCX документи з підтримкою тексту, таблиць, зображень, списків, шрифтів та користувацького форматування.

Що таке MarkdownToDocx?

У сьогоднішньому швидко розвиваючому світі розробки здатність безшовно конвертувати контент між форматами — це суперсила. Markdown став універсальною мовою для написання документації, блог‑постів та readme файлів завдяки своїй простоті. Перетворення Markdown‑файлів у формат Microsoft Word ніколи не було простішим для розробників Swift. Бібліотека MarkdownToDocx пропонує потужне, гнучке рішення для перетворення текстових Markdown‑документів у професійно відформатовані DOCX‑файли. Цей всеохопний посібник розкриває все, що вам потрібно знати про цю важливу Swift‑бібліотеку. Окрім базового форматування, бібліотека обробляє більш складні функції Markdown. Текст зі знаком перекреслення відображається з правильним форматуванням, блокові цитати мають особливий стиль, а таблиці конвертуються з повним збереженням структури, включаючи заголовки та дані клітинок.

MarkdownToDocx — це Swift‑бібліотека з відкритим кодом, яка безперешкодно конвертує Markdown‑документи у формат Microsoft Word DOCX. Побудована на парсері Apple MarkdownToDocx та використовує ZIPFoundation для створення архівів, ця бібліотека заповнює розрив між простим форматуванням тексту та професійною генерацією документів. Бібліотека відзначається простотою, одночасно пропонуючи розширені можливості налаштування для розробників, яким потрібен детальний контроль над стилем документу. Незалежно від того, чи створюєте ви додаток для нотаток, генератор документації або систему управління контентом, MarkdownToDocx надає необхідні інструменти.

Previous Next

Початок роботи з MarkdownToDocx

Рекомендований спосіб встановлення MarkdownToDocx — використання GitHub. Будь ласка, використайте наведену нижче команду для простого встановлення.

Встановити MarkdownToDocx через GitHub

$ 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")
]

Перетворення Markdown файлів у DOCX за допомогою Swift

Бібліотека MarkdownToDocx з відкритим кодом включає підтримку завантаження та конвертації markdown‑файлів у Word DOCX‑файли за допомогою Swift‑команд. Ви також можете конвертувати markdown‑файли безпосередньо, не завантажуючи їх у пам'ять спочатку. Такий підхід ефективніший для великих файлів, оскільки не вимагає попереднього завантаження всього файлу в рядок. Ось простий приклад, який показує, як розробники можуть конвертувати markdown‑файл у Word DOCX‑файл за допомогою Swift‑команд.

Як перетворити Markdown файли у 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 обробляє всі важливі параметри форматування тексту. Підкреслений (жирний) текст, курсив та перекреслений текст повністю підтримуються. Вбудовані блоки коду також правильно відображаються, зберігаючи моноширинне форматування, що розрізняє код від звичайного тексту. Нижче наведений простий приклад коду, що демонструє, наскільки легко конвертувати форматований текст. Конвертер автоматично розпізнає синтаксис Markdown і застосовує відповідне форматування у вихідному DOCX‑файлі.

Як перетворити форматований текст у Word DOCX за допомогою Swift бібліотеки?

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 дозволяє регулювати розташування вкладених елементів, гарантуючи, що ваші списки виглядають саме так, як ви бажаєте. Ось простий приклад, який демонструє, як це зробити.

Як перетворити вкладені списки Markdown за допомогою Swift бібліотеки?

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 та їх відображення з правильними межами та форматуванням клітинок.

Як відобразити таблиці Markdown за допомогою Swift бібліотеки?

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
 Українська