מילה לסימון

המרת Word ל-Markdown ב-C# .NET

בחיי היומיום שלנו, פורמטים שונים של מסמכים משמשים למטרות שונות. Markdown (MD) הפך לפורמט פופולרי ליצירת תוכן לאתרים, בלוגים ופלטפורמות מקוונות אחרות. מצד שני, Microsoft Word הוא אחד מכלי עיבוד התמלילים הנפוצים ביותר ליצירה ועריכה של מסמכים. עם זאת, כשמדובר בפרסום תוכן באינטרנט, ייתכן שמסמכי Word (DOC/DOCX) אינם הבחירה הטובה ביותר בשל מורכבות העיצוב שלהם. זה המקום שבו המרת מסמכי Word לפורמט Markdown שימושית. במאמר זה, נדון כיצד להמיר מסמכי Word לפורמט Markdown (MD) באמצעות C# ו- REST API.

Markdown היא בחירה פופולרית ליצירת מסמכים, במיוחד לכתיבה טכנית ומדעית, שכן היא מאפשרת עיצוב קל של טקסט ללא צורך בשימוש בכלי עיצוב מורכבים.

Word to Markdown Conversion API

Aspose.Words Cloud הוא REST API המאפשר למפתחים לבצע משימות עיבוד מסמכים שונות כגון המרה של Word ל-Markdown. בעזרת Aspose.Words Cloud SDK עבור .NET, תוכל להשתמש ב-API זה בקלות ביישומי NET שלך. הוא מציע דרך פשוטה ויעילה להמיר מסמכי Word לפורמט Markdown, ומאפשר לך להתמקד בלוגיקת הליבה של היישום שלך.

כעת, על מנת להשתמש ב-SDK, אנא חפש ‘Aspose.Words-Cloud’ במנהל החבילות של NuGet ולחץ על כפתור הוסף חבילה. שנית, השג את אישורי הלקוח שלך מ-Cloud Dashboard.

במקרה שאין לך חשבון קיים, פשוט צור חשבון בחינם באמצעות כתובת דוא"ל חוקית.

Word ל-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);
}
מילה ל-Markdown

תמונה: - תצוגה מקדימה של המרת Word to Markdown.

להלן הפרטים לגבי כל שורת קוד.

  • ראשית, יצרנו מופע של מחלקה Configuration תוך העברת זיהוי לקוח ואישורי סוד לקוח כארגומנטים.
  • שנית, צור אובייקט של WordsApi שבו נעביר אובייקט Configuration כארגומנט.
  • שלישית, קרא את מסמך Word הקלט מהכונן המקומי והעלה אותו לאחסון ענן בשיטת UploadFile(…).
  • לאחר מכן, צור מופע של GetDocumentWithFormatRequest שבו אנו מעבירים את שם קובץ הקלט, הפורמט המתקבל כ-MD ושם הקובץ המתקבל כארגומנטים.
  • לבסוף, קרא לשיטת GetDocumentWithFormat(..) כדי לבצע המרת Word ל-Markdown. לאחר ההמרה, הקובץ שנוצר נשמר גם באחסון הענן.

ניתן להוריד את מסמך Word לדוגמה המשמש בדוגמה לעיל מ-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, ולחסוך זמן יקר ומאמץ בתהליך יצירת התוכן.

קישורים שימושיים

מאמרים קשורים

אנא בקר בקישורים הבאים כדי ללמוד עוד על: