Aspose.Words Маркиране на файловите процесори за .NET

Aspose.Words Markdown File Processor за .NET позволява на разработчиците да създават, изтеглят, редактират и съхраняват документи за маркиране програмно с помощта на същия познат обект модел като аспоз.Вордс.Той е предназначен за динамично генериране на съдържание, автоматизация на документацията и трансформация на работните потоци, където маркирането е предпочитаният формат.

Инсталация и инсталиране

Поддържани платформи: Windows, Linux, macOS, мобилна операционна система с .NET Framework, .Net Core/5/6+, или Mono.ИДЕ: 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 файлове от дискове, потоци или ленти.
  • Съхранява структура: заглавия, таблици, списъци и форматиране на линии.
  • Поддържа блокове на кода, метаданни и референтни връзки.

DOM (Document Object Model) – модел на документални обекти)

  • Достъп и манипулация:

  • Параграфи и състезания (бълт, италиански, строг, инлайн код)

  • Глави (H1 – H6)

  • Списъци (по поръчка / без поръчане, нанесени)

  • Таблици, стълби и клетки

  • Код Блок и InlineCode

  • Линкове и изображения (с alt текст, заглавия и URL адреси)

Текст и Inline форматиране

  • Използвайте синтаксис Markdown чрез атрибути за изпълнение.
  • Смята се, че смелите (**), на италиански език (*), Накрая, тя е строга (~~), Кодът и кодовете (```).
  • Упражнява форматиране по параграфи и списъци надеждно.

Глави и секции

  • Програмиране на ръководните нива.
  • Реорганизиране на секции за TOC генерация.
  • Разделяне или сливане на блокове, базирани на заглавие.

Списък и списъци

  • Създаване на поръчка (1., 2.) а) или несъответстващо (-, *) и списъци.
  • Конвертирайте параграфи в елементи от списъка.
  • Вмъкнете, премахнете или трансформирайте списъчните типове динамично.

Tables

  • Създаване и манипулиране на GitHub флаворирани таблици за маркиране.
  • Въведете редове / колони, сливане на клетки и редактиране на съдържание.
  • Мултилинна поддръжка на клетките с запазено форматиране.

Снимки и връзки

  • Добавяне или актуализиране на референтни изображения (![alt](url "title")).
  • Включване на хипервръзки ([text](url "title")).
  • Поддържа инлайн и референтен стил на връзката синтакс.

Кодове блокове

  • Въведете блокирани код с езикови етикети (`csharp).
  • Управление на инлайн кодове с автоматично избягване.
  • Приспособяване на стилове на запек (бактици или тилди).

Метаданни и Front-Matter

  • Прочетете/пишете YAML или TOML предната материя.
  • Поддържайте метаданните за статични локални генератори (Hugo, Jekyll и т.н.).

Спестяване и износ

  • Спасете отново .md С опциите:

  • Съхранявайте бели пространства и коментари.

  • Нормализирайте индентацията и линиите.

  • Стрип или актуализиране на метаданни с callbacks.

Разширени примери

Редактиране на съществуваща марка 

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("```");

Най-добрите практики

  • Използвайте DOM APIs вместо regex за трансформации.
  • Централизирайте метаданните в предната материя за съвместимост на генератора.
  • Повторно използвайте обектите на документа за актуализации на комплекта.
  • Промени в веригата за минимизиране на използването на паметта.
  • Пре-топли АПИ в сървърни среди, за да се намали латентността на първото обаждане.
  • Проследяване на използването на лицензиране в тръбопроводи CI/CD.

Често използвани случаи

  • Автоматизиране ** README генерация**.
  • Изграждане на знание базирани статии динамично.
  • Конвертиране на структурирани данни в Markdown докове.
  • Поддръжката на голяма документация се поставя програматично.
  • Подготвяне на маркиране за статични локални генератори.

FAQ

**Кои функции за Markdown се поддържат?**Заглавия, списъци, таблички, изображения, връзки, форматиране на линии, блокове на кодове и предната материя.

**Мога ли да конвертирам Markdown в други формати?**Да, натоварване .md и да се съхранява в DOCX, PDF или HTML с помощта на Aspose.Words.

**Съхраняват ли се предните мачове?**Да е. Ямъл и секциите на TOML front-matter се четат / пишат.

**Поддържа ли се връзката по референтен стил?**Да. Поддържан е и инлайн и референтен стил на връзки.

**Това ли е безопасно?**Да, докато всяка лента използва своя собствена документация.

 Български