کلمه به علامت گذاری

تبدیل Word به Markdown در C#.NET

در زندگی روزمره ما، قالب های مختلف اسناد برای اهداف مختلف استفاده می شود. Markdown (MD) به یک قالب محبوب برای ایجاد محتوا برای وب‌سایت‌ها، وبلاگ‌ها و دیگر پلتفرم‌های آنلاین تبدیل شده است. از سوی دیگر، مایکروسافت ورد یکی از پرکاربردترین ابزارهای پردازش متن برای ایجاد و ویرایش اسناد است. با این حال، وقتی صحبت از انتشار محتوا به صورت آنلاین می شود، اسناد Word (DOC/DOCX) ممکن است به دلیل پیچیدگی های قالب بندی، بهترین انتخاب نباشند. اینجاست که تبدیل اسناد Word به فرمت Markdown مفید است. در این مقاله به نحوه تبدیل اسناد Word به فرمت Markdown (MD) با استفاده از C# و REST API خواهیم پرداخت.

Markdown یک انتخاب محبوب برای ایجاد اسناد، به ویژه برای نوشتن فنی و علمی است، زیرا امکان قالب بندی آسان متن را بدون نیاز به استفاده از ابزارهای قالب بندی پیچیده فراهم می کند.

API تبدیل Word به Markdown

Aspose.Words Cloud یک API REST است که توسعه دهندگان را قادر می سازد تا وظایف مختلف پردازش اسناد مانند تبدیل Word به Markdown را انجام دهند. با کمک Aspose.Words Cloud SDK for .NET، می توانید به راحتی از این API در برنامه های NET خود استفاده کنید. این یک راه ساده و کارآمد برای تبدیل اسناد Word به فرمت Markdown ارائه می دهد که به شما امکان می دهد بر منطق برنامه اصلی خود تمرکز کنید.

اکنون، برای استفاده از SDK، لطفا «Aspose.Words-Cloud» را در NuGet packages manager جستجو کنید و روی دکمه Add Package کلیک کنید. در مرحله دوم، اعتبار مشتری خود را از Cloud Dashboard دریافت کنید.

در صورتی که یک حساب کاربری موجود ندارید، به سادگی با استفاده از یک آدرس ایمیل معتبر یک حساب کاربری رایگان ایجاد کنید.

کلمه به MD در سی شارپ

لطفاً از قطعه کد زیر برای تبدیل 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 به Markdown.

در زیر جزئیات مربوط به هر خط کد ارائه شده است.

  • در مرحله اول، ما یک نمونه از کلاس Configuration را در حین ارسال Client ID و Client Secret به عنوان آرگومان ایجاد کرده ایم.
  • در مرحله دوم، یک شی از WordsApi ایجاد کنید که در آن شی Configuration را به عنوان آرگومان ارسال می کنیم.
  • ثالثاً، سند Word ورودی را از درایو محلی بخوانید و با استفاده از روش UploadFile(…) در فضای ذخیره سازی ابری آپلود کنید.
  • سپس، یک نمونه از GetDocumentWithFormatRequest ایجاد کنید که در آن نام فایل ورودی، فرمت نتیجه را به عنوان MD و نام فایل حاصل را به عنوان آرگومان ارسال می کنیم.
  • در نهایت، برای انجام تبدیل Word به Markdown، متد GetDocumentWithFormat(..) را فراخوانی کنید. پس از تبدیل، فایل حاصل نیز در فضای ذخیره سازی ابری ذخیره می شود.

نمونه سند Word استفاده شده در مثال بالا را می توان از [testdoc.docx] (https://github.com/aspose-words-cloud/aspose-words-cloud-dotnet/blob/master/ExamplesData/testdoc.docx) دانلود کرد ).

DOC برای علامت گذاری با استفاده از دستورات 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 تبدیل کنند و در زمان و تلاش ارزشمند در فرآیند تولید محتوا صرفه جویی کنند.

لینک های مفید

مقالات مرتبط

لطفا برای کسب اطلاعات بیشتر به لینک های زیر مراجعه کنید: