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

Markdown е популярен формат, използван за маркиране на текст и неговото допълнително преобразуване в HTML, PDF, DOCX или други формати. Много разработчици избират този формат за писане на документация, изготвяне на статии за публикуване на блогове, описание на проекти и т.н.

Markdown е толкова популярен, защото е лесно да се работи с този формат, както и тя може да бъде съвсем просто конвертирани в други формати. Поради тази причина, Aspose.Words осигурява възможност за преобразуване на документ в всеки поддържан формат на товара до Markdown и обратното. Aspose.Words също така поддържа най-популярните Запис на формати.

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

Конвертиране на документ

За да конвертирате документ в Markdown просто трябва да заредите документ във всеки поддържан формат или да създадете нов програмен формат. Тогава трябва да запазите документа за Markdown формат.

Следният пример за код показва как да се превърне DOX да 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 и са представени като подходящи стилове или директни формати:

  • Оферти са параграфи с Noright 1. .
  • Blockquotes are paragraphs with год
  • IndentedCode са параграфи с “IndentedCode” в името на стила
  • Ограда Код са параграфи с “FencedCode” в името на стила
  • InlineCode са работи с “InlineCode” в Font Име на стила
  • Хоризонтални правила са параграфи с HorizontalRule форма
  • Смел акцент
  • Italic акцент
  • 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.”
  • Различни маркери за първото ниво на списъка с куршуми ("-," “+” или “*,” по подразбиране маркера е горно- гол.) и различни видове номерация за поръчани списъци ("- или “) ,” по подразбиране маркерът е “).