تحويل ملفات 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. تم بناؤها على محلل MarkdownToDocx من Apple وتستفيد من 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 مع جميع خيارات تنسيق النص الأساسية. النص الغامق، النص المائل، وتنسيق الخط المشطوب مدعومة بالكامل. كما يتم عرض كتل الشيفرة المضمنة بشكل صحيح، مع الحفاظ على تنسيق الخط ذو العرض الأحادي الذي يميز الكود عن النص العادي. المثال البرمجي البسيط التالي يوضح مدى سهولة تحويل النص المنسق. يتعرف المحول تلقائيًا على صsyntax 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
 عربي