تبدیل HTML Markdown C#

Markdown یک زبان نشانه‌گذاری با نمادهای ساده است که نشان‌دهنده عنوان، پررنگ، مورب، زیرخط و موارد دیگر است. یادگیری و نوشتن آن ساده است، بنابراین بیشتر اسناد آنلاین و فایل های readme با استفاده از علامت گذاری نوشته می شوند. می توانید به راحتی با چند مرحله سریع، علامت گذاری را به صفحه وب HTML تبدیل کنید. به همین ترتیب، تبدیل HTML به markdown نیز یک ویژگی مفید است که در اینجا با استفاده از زبان C# بررسی خواهیم کرد.

HTML و Markdown Converter – نصب API

شما می توانید صفحه وب HTML و فایل های فرمت Markdown را با استفاده از زبان برنامه نویسی سی شارپ تبدیل کنید. برای دستکاری و تبدیل این فرمت‌های فایل باید Aspose.HTML for .NET API را نصب کنید. می‌توانید API را از گالری NuGet با دستور نصب زیر نصب کنید، یا می‌توانید فایل DLL را از بخش Downloads دانلود کنید تا آن را به عنوان مرجع در پروژه خود اضافه کنید.

PM> Install-Package Aspose.Html

تا اینجا شما قادر خواهید بود در عرض چند دقیقه API را پیکربندی کنید. اجازه دهید به بررسی سناریوهای مختلف ممکن ادامه دهیم:

تبدیل صفحه وب HTML به Markdown (.md) از طریق برنامه نویسی در سی شارپ

می توانید صفحه وب HTML را در برنامه های کاربردی مبتنی بر NET خود به Markdown تبدیل کنید. این ویژگی تبدیل محبوب به گونه‌ای پشتیبانی می‌شود که فقط باید API را بدون وارد شدن به جزئیات فرمت‌های فایل اصلی فراخوانی کنید. بنابراین، شما باید مراحل زیر را برای تبدیل صفحه وب HTML دنبال کنید:

  1. یک فایل HTML ایجاد کنید یا فایل ورودی موجود را بارگیری کنید
  2. روش ConvertHTML را با شی MarkdownSaveOptions فراخوانی کنید
  3. فایل خروجی Markdown (.md) را ذخیره کنید

کد زیر نحوه تبدیل صفحه وب HTML به Markdown را با استفاده از C# نشان می دهد:

// یک کد HTML آماده کنید و آن را در فایل ذخیره کنید.
var code = "<h1>Header 1</h1>" +
            "<h2>Header 2</h2>" +
            "<p>Hello World!!</p>";
System.IO.File.WriteAllText(dataDir + "document.html", code);

// برای تبدیل HTML به Markdown، متد ConvertHTML را فراخوانی کنید.
Aspose.Html.Converters.Converter.ConvertHTML(dataDir + "document.html", new Aspose.Html.Saving.MarkdownSaveOptions(), dataDir + "output.md");

تبدیل صفحه وب HTML به Markdown MD (.md) با گزینه های اضافی در سی شارپ

ما قبلاً کاربرد ساده و اساسی تبدیل HTML به علامت گذاری Markdown را آموخته ایم. اجازه دهید یک گام دیگر جلوتر برویم که در آن فرآیند تبدیل را کنترل خواهیم کرد. سناریویی را در نظر بگیرید که در آن داده های نامربوط زیادی در یک فایل HTML وجود دارد، اما ما فقط باید محتویات آن را به تگ های پاراگراف یا هایپرلینک تبدیل کنیم. ما برای درک این ویژگی مراحل زیر را دنبال می کنیم و آن را امتحان می کنیم:

  1. یک فایل HTML ورودی را بارگیری کنید
  2. شیء MarkdownSaveOptions را مقداردهی کنید
  3. متغیرهای Flag را تحت ویژگی Features قرار دهید
  4. فایل Markdown خروجی را ذخیره کنید

کد زیر بر اساس این مراحل است که نحوه تبدیل صفحه وب HTML به Markdown را با گزینه های اضافی با استفاده از C# نشان می دهد:

// یک کد HTML آماده کنید و آن را در فایل ذخیره کنید.
var code = "<h1>Header 1</h1>" +
            "<h2>Header 2</h2>" +
            "<p>Hello World!!</p>" +
            "<a href='aspose.com'>aspose</a>";
System.IO.File.WriteAllText(dataDir + "document.html", code);

// یک نمونه از SaveOptions ایجاد کنید و قانون را تنظیم کنید: 
// - فقط <a>و</a><p style=";text-align:right;direction:rtl"> <a>عناصر به علامت گذاری تبدیل می شوند.</a>
var options = new Aspose.Html.Saving.MarkdownSaveOptions();
options.Features = Aspose.Html.Saving.MarkdownFeatures.Link | Aspose.Html.Saving.MarkdownFeatures.AutomaticParagraph;

// برای تبدیل HTML به Markdown، متد ConvertHTML را فراخوانی کنید.
Aspose.Html.Converters.Converter.ConvertHTML(dataDir + "document.html", options, dataDir + "output_options.md");

تبدیل Markdown (.md) به صفحه وب HTML از طریق برنامه نویسی با استفاده از C#

ممکن است در برخی از سناریوها لازم باشد HTML را به علامت Markdown تبدیل کنید. به عنوان مثال، برخی از بخش های مستندسازی در برنامه های کاربردی وب و بسیاری از موارد استفاده دیگر مورد استفاده قرار می گیرند. با انجام مراحل زیر می توانید به راحتی فایل Markdown را به HTML تبدیل کنید:

  1. یک فایل Markdown (.md) ایجاد کنید یا فایل ورودی را بارگذاری کنید
  2. فایل HTML خروجی را با روش ConvertMarkdown ذخیره کنید

کد زیر نحوه تبدیل فایل Markdown (.md) به صفحه وب HTML با استفاده از زبان برنامه نویسی C# را نشان می دهد:

// یک مثال ساده Markdown آماده کنید
var code = "### Hello World" +
            "\r\n" +
            "[visit applications](https://products.aspose.app/html/family)";
// یک فایل Markdown ایجاد کنید
System.IO.File.WriteAllText(dataDir + "input_document.md", code);

// تبدیل Markdown به سند HTML
Aspose.Html.Converters.Converter.ConvertMarkdown(dataDir + "input_document.md", dataDir + "MarkdownToHTMLoutput.html");

دانلود نمونه پروژه و فایل های نمونه

ما یک نمونه پروژه را به عنوان نمایشی از ویژگی های ذکر شده جمع آوری کرده ایم که می توانید فایل های نمونه را نیز دانلود کنید. این یک برنامه کنسولی است که می توانید برای کشف و درک ویژگی های بین تبدیل علامت گذاری و HTML امتحان کنید. بنابراین می‌توانید ZIP را دانلود کنید یا مخزن GitHub را برای آزمایش ویژگی‌ها شبیه‌سازی کنید.

نتیجه

به طور خلاصه، ما تبدیل صفحات وب HTML و فایل های Markdown را به تفصیل بررسی کرده ایم. API می تواند این فایل ها را به سرعت و کارآمد با تماس های ساده API تبدیل کند. علاوه بر این، می‌توانید با مراجعه به Product Documentation و API References ویژگی‌های دیگر را بیاموزید. با این حال، در صورت هر گونه نگرانی، لطفاً از طریق [تالار گفتمان پشتیبانی رایگان12 با ما در تماس باشید.

همچنین ببینید