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

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

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

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

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

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

Следващият пример за код показва как да конвертирате DOCX в Markdown:

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

Задаването на папка чрез ImagesFolder също е полезно, ако запишете документ в поток и Aspose.Words няма папка за записване на изображения.

Ако зададеното ImagesFolder не съществува, то ще бъде създадено автоматично.

Следващият пример за код показва как да зададете папка за изображения, когато записвате документ в поток:

Задайте опциите за записване при конвертиране в Markdown

Aspose.Words предоставя възможност за използване на класа MarkdownSaveOptions за работа с разширени опции при записване на документ във формат Markdown. Повечето свойства са наследяване или претоварване свойства, които вече съществуват в рамките на други Aspose.Words.Saving Пространство от имена класове. В допълнение към тях са добавени редица свойства, които са специфични за Markdown формат. Например свойство TableContentAlignment за управление на подравняването на съдържание в таблици или ImageSavingCallback и ImagesFolder за управление на начина на записване на изображения при конвертиране на документ във формат Markdown.

Поддържани Markdown Функции

Aspose.Words в момента поддържа следните Markdown функции, които най-често следват спецификацията CommonMark в Aspose.Words API и са представени като подходящи стилове или директно форматиране:

• Заглавията са параграфи с Heading 1 - Heading 6 стилове
• Блоковете са параграфи с “цитат” в името на стила
• IndentedCode са параграфи с" IndentedCode " в името на стила
• FencedCode са параграфи с" FencedCode " в името на стила
• InlineCode се изпълняват с “InlineCode " в името на стила Font
• Хоризонталните правила са параграфи с форма HorizontalRule
• Удебелен акцент
• Курсив акцент
• StrikeThrough форматиране
• Списъците са номерирани или водещи параграфи
• Таблиците са представени с клас Table
• Връзките са представени като FieldHyperlink клас

Следващият пример показва как да създадете документ с някои стилове и да го запишете на Markdown:

Резултатът от този пример за код е показан по-долу.

Полезни Съвети

Има няколко нюанса и интересни случаи, след като сте научили, че можете да работите с Markdown файлове по-гъвкаво и удобно. Например, способността да се използва:

• SetextHeading това ви позволява да създавате многоредови заглавия във Markdown, докато обикновените заглавия във Markdown могат да бъдат само едноредови. SetextHeading се основава на стил “Заглавие Н” и нивото му може да бъде само 1 или 2. Ако Н в “позиция Н” е по-голяма или равна на 2, тогава съответното SetextHeading се основава на “Heading 2”, в противен случай на “Heading 1”.
• Различни маркери за първото ниво на списъци с водещи символи ("-”, “+” или “*”, маркерът по подразбиране е “-”.) и различни видове номериране за подредени списъци ("." или “)”, маркерът по подразбиране е “.").