في حياتنا اليومية ، يتم استخدام تنسيقات المستندات المختلفة لأغراض مختلفة. Markdown (MD) أصبح تنسيقًا شائعًا لإنشاء محتوى لمواقع الويب والمدونات والأنظمة الأساسية الأخرى عبر الإنترنت. من ناحية أخرى ، يعد Microsoft Word أحد أكثر أدوات معالجة الكلمات استخدامًا لإنشاء المستندات وتحريرها. ومع ذلك ، عندما يتعلق الأمر بنشر المحتوى عبر الإنترنت ، قد لا تكون مستندات Word (DOC / DOCX) هي الخيار الأفضل نظرًا لتعقيدات التنسيق الخاصة بها. هذا هو المكان الذي يكون فيه تحويل مستندات Word إلى تنسيق Markdown مفيدًا. في هذه المقالة ، سنناقش كيفية تحويل مستندات Word إلى تنسيق Markdown (MD) باستخدام C# و REST API.
يعد Markdown خيارًا شائعًا لإنشاء المستندات ، خاصةً للكتابة التقنية والعلمية ، حيث يتيح تنسيق النص بسهولة دون الحاجة إلى استخدام أدوات تنسيق معقدة.
Word to Markdown التحويل API
Aspose.Words Cloud هي واجهة برمجة تطبيقات REST تمكن المطورين من أداء مهام معالجة المستندات المختلفة مثل تحويل Word إلى Markdown. بمساعدة [Aspose.Words Cloud SDK for .NET] (https://products.aspose.cloud/words/net/) ، يمكنك بسهولة استخدام واجهة برمجة التطبيقات هذه في تطبيقات .NET. يوفر طريقة بسيطة وفعالة لتحويل مستندات Word إلى تنسيق Markdown ، مما يسمح لك بالتركيز على منطق التطبيق الأساسي الخاص بك.
الآن ، من أجل استخدام SDK ، يرجى البحث عن “Aspose.Words-Cloud” في مدير حزم NuGet والنقر فوق الزر “إضافة حزمة”. ثانيًا ، احصل على بيانات اعتماد العميل من Cloud Dashboard.
في حال لم يكن لديك حساب حالي ، ما عليك سوى إنشاء حساب مجاني باستخدام عنوان بريد إلكتروني صالح.
كلمة إلى MD في C#
يرجى محاولة استخدام مقتطف الشفرة التالي لتحويل Word إلى MD باستخدام C# .NET.
// احصل على بيانات اعتماد العميل من https://dashboard.aspose.cloud/
string clientSecret = "d757548a9f2558c39c2feebdf85b4c44";
string clientID = "4db2f826-bf9c-42e7-8b2a-8cbca2d15553";
// إنشاء كائن التكوين باستخدام ClinetID وتفاصيل Client Secret
var config = new Configuration { ClientId = clientID, ClientSecret = clientSecret };
// تهيئة مثيل WordsApi
var wordsApi = new WordsApi(config);
// اسم ملف الإدخال
String inputFile = "test_doc.docx";
// اسم الملف الناتج
String resultant = "resultant.md";
// تنسيق الملف الناتج
String format = "MD";
try
{
// تحميل الملف من محرك الأقراص المحلي
using (var file = System.IO.File.OpenRead(inputFile))
{
var uploadFileRequest = new UploadFileRequest(file, inputFile);
// تحميل الملف إلى التخزين السحابي
wordsApi.UploadFile(uploadFileRequest);
}
// إنشاء كائن طلب DocumentWithFormat
var response = new GetDocumentWithFormatRequest(inputFile, format,outPath: resultant);
// بدء تشغيل المستند
wordsApi.GetDocumentWithFormat(response);
// اطبع رسالة النجاح إذا نجح التحويل
if (response != null && response.Equals("OK"))
{
Console.WriteLine("Word to Markdown conversion successfull !");
Console.ReadKey();
}
}catch (Exception ex)
{
Console.WriteLine("error:" + ex.Message + "\n" + ex.StackTrace);
}
فيما يلي تفاصيل حول كل سطر رمز.
- أولاً ، قمنا بإنشاء مثيل لفئة التكوين أثناء تمرير بيانات اعتماد Client ID و Client Secret كوسائط.
- ثانيًا ، قم بإنشاء كائن من WordsApi حيث نقوم بتمرير كائن التكوين كوسيطة.
- ثالثًا ، اقرأ مستند Word المدخل من محرك الأقراص المحلي وقم بتحميله على التخزين السحابي باستخدام طريقة UploadFile (…).
- بعد ذلك ، قم بإنشاء مثيل GetDocumentWithFormatRequest حيث نقوم بتمرير اسم ملف الإدخال والتنسيق الناتج مثل MD واسم الملف الناتج كوسائط.
- أخيرًا ، قم باستدعاء أسلوب GetDocumentWithFormat (..) لإجراء تحويل من Word إلى Markdown. بعد التحويل ، يتم حفظ الملف الناتج أيضًا في التخزين السحابي.
يمكن تنزيل نموذج مستند Word المستخدم في المثال أعلاه من [testdoc.docx] (https://github.com/aspose-words-cloud/aspose-words-cloud-dotnet/blob/master/ExamplesData/testdoc.docx ).
DOC لعملية Markdown باستخدام أوامر cURL
من خلال استخدام أوامر cURL و Aspose.Words Cloud ، يمكنك تحويل مستندات Word بسرعة وسهولة إلى تنسيق Markdown دون الحاجة إلى كتابة أي تعليمات برمجية مخصصة. يسمح هذا الأسلوب بالتكامل السلس مع تدفقات العمل والأدوات الحالية ، مما يوفر الوقت والجهد. لذا ، فإن استخدام أوامر cURL و Aspose.Words Cloud ، لتحويل Word إلى Markdown يوفر حلاً بسيطًا وفعالاً وقابل للتخصيص لاحتياجات تحويل المستندات الخاصة بك.
لبدء هذا النهج ، نحتاج إلى إنشاء accessToken (بناءً على بيانات اعتماد العميل). يرجى تنفيذ الأمر التالي:
curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=bb959721-5780-4be6-be35-ff5c3a6aa4a2&client_secret=4d84d5f6584160cbd91dba1fe145db14" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"
بمجرد إنشاء “{accessToken}” ، يرجى تنفيذ الأمر التالي لتحميل مستند Word من التخزين السحابي والتحويل إلى تنسيق Markdown (md). لقد استخدمنا المعلمة -o التي تحفظ الإخراج على محرك أقراص محلي.
curl -v "https://api.aspose.cloud/v4.0/words/test_doc.docx?format=MD" \
-X GET \
-H "accept: application/octet-stream" \
-H "Authorization: Bearer <accessToken>" \
-o "resultant.md"
خاتمة
في الختام ، يمكن أن تؤدي القدرة على تحويل مستندات Word إلى تنسيق Markdown إلى تبسيط عملية إنشاء المحتوى بشكل كبير للمطورين والمدونين والكتاب التقنيين. يوفر Aspose.Words Cloud حلاً بسيطًا ولكنه قوي لتحقيق هذا التحويل ، مع مرونة استخدام أوامر .NET SDK أو cURL. باستخدام هذه الأداة ، يمكن للمستخدمين بسهولة تحويل مستندات Word الخاصة بهم إلى تنسيق Markdown ، مما يوفر الوقت والجهد الثمين في عملية إنشاء المحتوى.
روابط مفيدة
مقالات ذات صلة
يرجى زيارة الروابط التالية لمعرفة المزيد حول: