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