Aspose.Words Markdown File Processor для .NET

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

Инсталляция и установка

Поддерживаемые платформы: 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

  • Повязки и изображения (с альт-текстом, заголовками и URL-адресами)

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

  • Применяйте синтаксию Markdown через Run Attributes.
  • Помощь и смелость (**), Итальянский язык (*), В строгом порядке (~~), а) и инлайн код (```).
  • Сделайте форматирование по параграфам и спискам надежно.

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

  • Программатически корректировать основные уровни.
  • Реорганизация секций для генерации TOC.
  • Разделение или слияние блоков на основе заголовка.

Списки и перечисленные списки

  • Постановление по заказу (1., 2.) а) или неисполняется (-, *) и списки.
  • Конвертируйте параграфы в элементы списка.
  • Введите, удаляйте или динамично преобразуйте типы списка.

Таблицы

  • Создайте и манипулируйте таблицами Markdown с помощью GitHub.
  • Введите строки/колонны, сливайте клетки и редактируйте контент.
  • Мултилинная клеточная поддержка с сохранением форматирования.

Фотографии и ссылки

  • Добавить или обновлять ссылки на изображения (![alt](url "title")).
  • Включение гиперссылок ([text](url "title")).
  • Поддерживает inline и reference-style link syntax.

Код блоков

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

Метаданные и фронт-матер

  • Читайте и напишите YAML или TOML фронтальный матч.
  • Сохранение метаданных для статических локальных генераторов (Хуго, Джекилла и т.д.).

Экономия и экспорт

  • Спасти обратно к .md С опциями:

  • Сохраните пространство и комментарии.

  • Нормализуйте индентацию и линейные окончания.

  • Стрип или обновление метаданных с помощью звонков.

продвинутые примеры

Редактировать существующий маркер 

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 вместо регекса для трансформаций.
  • Централизуйте метаданные в переднем материале для совместимости генератора.
  • Повторно использовать объекты документа для обновления батарей.
  • Изменения цепочки для минимизации использования памяти.
  • Пре-теплые АПИ в серверных средах для снижения латенции первого звонка.
  • Следите за использованием лицензионных трубопроводов CI/CD.

Общие случаи использования

  • Автоматизация «Прочитаемое поколение.
  • Создание книги базы знаний динамично.
  • Конвертирование структурированных данных в доки Markdown.
  • Сохранение большой документации устанавливает программатически.
  • Подготовка маркировки для генераторов статического сайта.

FAQ

**Какие функции Markdown поддерживаются?**Названия, списки, таблицы, изображения, ссылки, форматирование в строке, блоки кода и фронт-матер.

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

**Сохраняется ли фронтальный матч?**И да. Ямль и секции TOML front-matter читаются/писываются.

**Поддерживает ли он ссылки в стиле ссылок?**Да. Поддерживаются как inline, так и ссылки в стиле ссылок.

**Что это безопасно?**Да, пока каждая лента использует свой собственный документ.

 Русский