پردازشگر فایل Aspose.Words Markdown برای .NET

Aspose.Words Markdown File Processor برای .NET به توسعه دهندگان اجازه می دهد تا تولید، بارگذاری، ویرایش و ذخیره اسناد علامت گذاری برنامه نویسی با استفاده از همان مدل اشیاء شناخته شده به عنوان ASPOSE.Vords طراحی شده است برای تولید محتوا پویا، اتوماسیون مستندات، و جریان های کار تبدیل که در آن برچسب گذاری فرمت مورد علاقه است.

نصب و نصب

  • نصب بسته NuGet Aspose.Words.
  • برای ثبت نام مجوز ( مجوز متریکی ).
  • اضافه کردن به Aspose.Words نام خود را به پروژه خود اضافه کنید.
  • برای اهداف چارچوب و تنظیمات بسته، نگاهی به راهنمای نصب .

پلتفرم های پشتیبانی شده: ویندوز، لینوکس، macOS، OS تلفن همراه با .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 فایل ها از دیسک ها، جریان ها یا نوارها.
  • ساختار را حفظ می کند: عناوین، جدول ها، لیست ها و فرمت در خط.
  • حفظ لینک های بلوک کد، متا داده ها و سبک مرجع.

مدل اسناد (Document Object Model)

  • دسترسی و دستکاری:

  • پاراگراف ها و اجراها (کد باله، ایتالیایی، سخت، در خط)

  • سرها (H1 تا H6)

  • فهرست ها (در صورت سفارش / بدون سفارش، نستیده)

  • میزها، گردن ها و سلول ها

  • کد بلاک و InlineCode گره ها

  • لینک ها و تصاویر (با متن، عناوین و URL ها)

متن و Inline Formatting

  • استفاده از Markdown Syntax از طریق ویژگی های اجرا.
  • با شجاعت (**), ایتالیایی (*), و به سختی (~~), و کد inline (```).
  • فرمت را از طریق پاراگراف ها و لیست ها به طور قابل اعتماد انجام دهید.

شاخه ها و بخش ها

  • به صورت برنامه نویسی تنظیم می شود.
  • بازسازی بخش ها برای تولید TOC.
  • تقسیم یا ترکیب بلوک های مبتنی بر سر.

لیست ها و لیست های نازک

  • سفارش داده شده است (1., 2.) و یا به صورت غیرمستقیم (-, *) لیست ها.
  • پاراگراف ها را به عناصر لیست تبدیل کنید.
  • نوع لیست را به صورت پویا وارد، حذف یا تبدیل کنید.

جدول ها

  • ایجاد و دستکاری جدول های Markdown GitHub.
  • خطوط / ستون ها را وارد کنید، سلول های ترکیبی و محتوای ویرایش کنید.
  • پشتیبانی از سلول های چندگانه با فرمت حفظ شده.

تصاویر و لینک ها

  • اضافه کردن یا به روز رسانی تصاویر مرجع (![alt](url "title")).
  • با استفاده از Hyperlinks ([text](url "title")).
  • پشتیبانی از سنتاکس لینک inline و reference-style.

کد بلوک

  • بلاک های کد با برچسب های زبان (`csharp) را وارد کنید).
  • مدیریت خطوط کد با فرار خودکار.
  • سبک های چوبی را سفارشی کنید (باکتیک ها یا تیلدها).

فورماتیک و Front-Matter

  • خواندن / نوشتن YAML یا TOML جلوی موضوع.
  • حفظ داده های متا برای ژنراتورهای موقعیت استاتیک (Hugo، Jekyll، و غیره.).

صرفه جویی و صادرات

  • نجات بازگشت به .md با گزینه ها:

  • فضای سفید و نظرات را حفظ کنید.

  • به طور معمول اندانت و خط پایان می یابد.

  • ارسال و یا به روز رسانی داده های متابولیک با CallBack.

نمونه های پیشرفته

برچسب های موجود 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.

موارد استفاده رایج

  • دانلود نرم افزار Readme Generation.
  • ساختن ** مقالات پایه دانش** به صورت پویا.
  • تبدیل داده های ساختاری به دکمه های Markdown.
  • نگهداری اسناد بزرگ به صورت برنامه نویسی تنظیم می شود.
  • آماده سازی Markdown برای ژنراتورهای موقعیت استاتیک.

FAQ

**چه ویژگی های Markdown پشتیبانی می شود?**عناوین، لیست ها، میزها، تصاویر، لینک های، فرمت در خط، بلوک های کد و جلوی موضوع.

**آیا می توانم Markdown را به فرمت های دیگر تبدیل کنم?**بله شارژ .md و ذخیره به DOCX، PDF، یا HTML با استفاده از Aspose.Words.

**آیا امام خمینی (ره) حفظ شده است?**بله. یامال و بخش های جلویی TOML خوانده / نوشته شده است.

**آیا از لینک های سبک مرجع پشتیبانی می کند?**بله، هر دو لینک های inline و reference-style پشتیبانی می شوند.

**آیا تایلند امن است?**بله، تا زمانی که هر نوار از مثال سند خود استفاده می کند.

 فارسی