Преобразовать документ в Markdown

Markdown Это популярный формат, используемый для разметки текста и его дальнейшего преобразования в HTML, PDF, DOCX или другие форматы. Многие разработчики выбирают этот формат для написания документации, подготовки статей для публикации в блогах, описания проектов и так далее.

Markdown Он настолько популярен, что с ним легко работать, а также его можно довольно просто конвертировать в другие форматы. По этой причине, Aspose.Words Возможность конвертировать документ в любой поддерживаемый формат загрузки то Markdown и наоборот – Aspose.Words Поддерживает самые популярные Сохранить форматы.

Теперь функциональность для работы с Markdown Формат активно разрабатывается, чтобы предоставить вам больше возможностей для удобной и комфортной работы с документами.

Преобразовать документ

Преобразовать документ в Markdown Вам просто нужно загрузить документ в любом поддерживаемом формате или создать новый программно. Затем необходимо сохранить документ для Markdown Формат.

Следующий пример кода показывает, как преобразовать DOCX в Markdown:

.NET

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET
// Load the document from disk.
Document doc = new Document(dataDir + "Test.docx");
// Save the document to Markdown format.
doc.Save(dataDir + "SaveDocx2Markdown.md");

Вы также можете указать физическую папку, в которой вы хотите сохранить изображения при экспорте документа. Markdown Формат. По умолчанию, Aspose.Words сохраняет изображения в той же папке, где сохранен файл документа, но вы можете отменить это поведение, используя ImagesFolder собственность.

Укажите папку через ImagesFolder Это также полезно, если вы сохраняете документ в потоке. Aspose.Words Не имеет папки для сохранения изображений.

Если указанный ImagesFolder Не существует, он будет создан автоматически.

Следующий пример кода показывает, как указать папку для изображений при сохранении документа в потоке:

.NET

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET
// Load the document from disk.
Document doc = new Document(dataDir + "Test.docx");
MarkdownSaveOptions so = new MarkdownSaveOptions();
so.ImagesFolder = dataDir + "\\Images";
using (MemoryStream stream = new MemoryStream())
doc.Save(stream, so);

Укажите параметры сохранения при переходе на Markdown

Aspose.Words дает возможность использовать MarkdownSaveOptions класс для работы с расширенными вариантами при сохранении документа на Markdown Формат. Большинство свойств наследуют или перегружают свойства, которые уже существуют в других. Aspose.Words.Saving Классы пространства имен. Кроме того, ряд свойств, которые являются специфическими для Markdown Также добавлен формат. Например, в TableContentAlignment свойство контролировать выравнивание контента в таблицах, или ImageSavingCallback и ImagesFolder контролировать, как изображения сохраняются при преобразовании документа в Markdown Формат.

Поддерживаемый Markdown Особенности

Aspose.Words В настоящее время поддерживает следующие Markdown Особенности, которые в основном следуют CommonMark Спецификация в Aspose.Words API и представлены в виде соответствующих стилей или прямого форматирования:

  • Заголовки - это абзацы с заголовком 1 - заголовки 6 стилей
  • Блоккоты - это абзацы с “цитатами” в названии стиля
  • IndentedCode - параграфы с “IndentedCode” в названии стиля
  • Огражденный Код - это абзацы с “FencedCode” в названии стиля
  • InlineCode работает с “InlineCode” в Font Название стиля
  • Горизонтальные правила - это параграфы с HorizontalRule форма
  • Смелый акцент
  • Итальянский акцент
  • StrikeThrough форматирование
  • Списки пронумерованы или пронумерованы
  • Таблицы представлены с Table класс
  • Ссылки представлены как FieldHyperlink класс

Следующий пример показывает, как создать документ с некоторыми стилями и сохранить его. Markdown:

.NET

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Specify the "Heading 1" style for the paragraph.
builder.InsertParagraph();
builder.ParagraphFormat.StyleName = "Heading 1";
builder.Write("Heading 1");
// Specify the Italic emphasis for the paragraph.
builder.InsertParagraph();
// Reset styles from the previous paragraph to not combine styles between paragraphs.
builder.ParagraphFormat.StyleName = "Normal";
builder.Font.Italic = true;
builder.Write("Italic Text");
// Reset styles from the previous paragraph to not combine styles between paragraphs.
builder.Italic = false;
// Specify a Hyperlink for the desired text.
builder.InsertParagraph();
builder.InsertHyperlink("Aspose", "https://www.aspose.com", false);
builder.Write("Aspose");
// Save your document as a Markdown file.
doc.Save("example.md");

Результат этого примера кода показан ниже.

markdown-example-aspose-words-net

Полезные советы

Есть несколько нюансов и интересных случаев, узнав, с чем можно работать. Markdown Файлы более гибко и удобно. Например, есть возможность использовать:

  • SetextHeading позволяет создавать многострочные заголовки в Markdown В то время как регулярные заголовки в Markdown может быть только однолинейным. SetextHeading основан на стиле “Heading N”, и его уровень может быть только 1 или 2. Если N в “Голова N” больше или равна 2, то соответствующая SetextHeading основана на “Голова 2”, иначе на “Голова 1”.
  • Различные маркеры для первого уровня маркированных списков ("-", “+” или “*”, маркер по умолчанию - “-") и различные типы нумерации для упорядоченных списков (”" или “"), маркер по умолчанию - “”.).