معالج ملفات Aspose.Words Markdown لـ .NET

Aspose.Words Markdown File Processor for .NET يسمح للمطورين بإنشاء وتحميل وتحرير وتخزين مستندات markdown بطريقة برمجية باستخدام نفس نموذج الكائن المألوف مثل ASPOSE. Words.

تثبيت وإعداد

  • قم بتثبيت حزمة NuGet Aspose.Words.
  • إرسال رسالة خاصة إليك ( ترخيص مقيد ).
  • أضف إلى Aspose.Words اسم المشروع الخاص بك.
  • بالنسبة لأهداف الإطار وإعدادات الحزمة، انظر دليل التركيب .

**المنصات المدعومة: ** ويندوز، لينكس، ماكوس، نظام التشغيل المحمول مع .NET Framework، .NET Core/5/6+، أو Mono.IDEs: Visual Studio 2010–2022, Xamarin, MonoDevelop.

البدء السريع: إنشاء ملف Markdown 

var doc = new Document();
var builder = new DocumentBuilder(doc);

// Insert a horizontal rule (renders as '-----' in Markdown)
builder.InsertHorizontalRule();

doc.Save("Output.md");

الخصائص والوظائف

إنشاء الوثيقة

  • توليد جديد .md الملفات ديناميكية.
  • إدخال العناوين والفقرات والقوائم والجدول والبيانات الميتا.
  • إعداد خصائص المستوى الوثائقي مثل العنوان والكاتب والعلامات.

تحميل الوثيقة

  • الحمل الحالي .md الملفات من الأقراص أو الشرائح أو الأسلاك.
  • يحافظ على الهيكل: العناوين والجدول والقوائم والتصميم داخل الخط.
  • يحافظ على قواعد الكود، والبيانات المتعددة، وارتباطات النمط المرجعي.

نموذج الكائنات الوثائقية (DOM)

  • الوصول والتلاعب:

  • الفقرات والركض (بالد، الإيطالية، صارمة، رمز في الخط)

  • الرؤوس (H1 – H6)

  • القوائم (مطلوبة / غير مسجلة ، محصورة)

  • الألواح والأقواس والخلايا

  • كود بلاك و InlineCode

  • الروابط والصور (مع النص الأصلي، العناوين، وURL)

النص و Inline Formatting

  • تطبيق Markdown syntax من خلال ميزات تشغيل.
  • وَقَوْلُهُ تَعَالَى (**), إيطاليا (*), وَلَمْ يَكُنْ لَهُ قَوْمٌ عَظِيم (~~), وأيضًا إدخال الرمز (```).
  • يتعامل مع تنسيق عبر الفقرات والقوائم بشكل موثوق.

الرؤوس والأقسام

  • التعديل البرمجي للمستويات الرئيسية.
  • إعادة ترتيب الأقسام لتوليد TOC.
  • تقسيم أو دمج الكتل القائمة على العنوان.

القوائم والقوائم المضغوطة

  • أضف تعليقًا (1., 2.) وَقَوْلُهُ تَعَالَى: {وَمَا كَانُوا يَكْسِبُون (-, *) القوائم.
  • تحويل الفقرات إلى عناصر القائمة.
  • إدخال أو إزالة أو تحويل أنواع القائمة بشكل ديناميكي.

الجدول

  • إنشاء وتلاعب لوحات Markdown مع GitHub.
  • إدخال الصفوف / الأعمدة ، ودمج الخلايا ، وتحرير المحتوى.
  • دعم الخلايا المتعددة مع التنسيق المحفوظ.

صور و الروابط

  • إضافة أو تحديث إشارات الصورة (![alt](url "title")).
  • تداول الخيارات الثنائية ([text](url "title")).
  • يدعم التركيب الإداري والنمط المرجعي.

كود الكتلة

  • إدخال الكتل الرمزية مع علامات اللغة (‘‘csharp).
  • إدارة الرموز داخل الخط مع الهروب الذاتي.
  • تخصيص أنماط الخرسانة (الخلفيات أو الأقواس).

الوسائط و Front-Matter

  • اقرأ / اكتب YAML أو TOML المادة الأمامية.
  • الحفاظ على البيانات الميتالية لمولدات الموقع الثابت (هوغو، جيكيل، إلخ.).

الادخار والتصدير

  • إنقاذ العودة إلى .md مع الخيارات:

  • حفظ الفضاء والتعليقات.

  • إعادة تدوير الخطوط والنهايات.

  • سحب أو تحديث البيانات الميتا باستخدام ردود الفعل.

أمثلة متقدمة

إرسال رسالة خاصة إلى Markdown 

var doc = new Document("Quotes.md");
var builder = new DocumentBuilder(doc);

builder.MoveToDocumentEnd();
builder.ParagraphFormat.ClearFormatting();
builder.Writeln("\n");

// Insert inline code with backticks
var inlineCodeStyle = doc.Styles.Add(StyleType.Character, "InlineCode.3");
builder.Font.Style = inlineCodeStyle;
builder.Writeln("Produced by Aspose.Words Markdown Processor.");

doc.Save("UpdatedQuotes.md");

إدخال كود بلاك 

var builder = new DocumentBuilder(new Document());
builder.Writeln("```csharp");
builder.Writeln("Console.WriteLine(\"Hello Markdown\");");
builder.Writeln("```");

أفضل الممارسات

  • استخدم APIs DOM بدلاً من regex للتحولات.
  • تركيز البيانات الميتا في المادة الأمامية لتوافق المولدات.
  • إعادة استخدام كائنات المستند لتحديثات المجموعة.
  • تعديلات السلسلة لتقليل استخدام الذاكرة.
  • التدفئة المسبقة APIs في بيئات الخادم للحد من تأخير المكالمة الأولى.
  • تتبع استخدام الترخيص في أنابيب CI/CD.

حالات الاستخدام المشترك

  • أوتوماتيك ** الجيل القراءة**.
  • بناء مقالات قاعدة المعرفة ديناميكية.
  • تحويل البيانات المنظمة إلى سجلات Markdown.
  • الحفاظ على الوثائق الكبيرة يتم وضعها برمجة.
  • إعداد Markdown لمولدات الموقع الثابت.

FAQ

**ما هي ميزات Markdown التي يتم دعمها?**العناوين ، القوائم ، اللوحات ، الصور ، الروابط ، تنسيق الخطوط ، الكتل الرمزية ، والمادة الأمامية.

**هل يمكنني تحويل Markdown إلى تنسيقات أخرى?**نعم تحميل .md وتخزينها إلى DOCX أو PDF أو HTML باستخدام Aspose.Words.

**هل تم الحفاظ على الجبهة الأمامية?**نعم. ياميل ويتم قراءة / كتابة أقسام TOML الأمامية.

**هل يدعم الروابط النمط المرجعي?**نعم، يتم دعم كل من الروابط inline و reference-style.

**هل هي آمنة?**نعم ، طالما أن كل شريط يستخدم مثال المستند الخاص به.

 عربي