Перетворити документ на 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
- Блок-лапки - це абзаци з написом “Quote” у назві стилю
- IndentedCode - це абзаци з “IndentedCode " у назві стилю
- FencedCode - це абзаци з “FencedCode " у назві стилю
- InlineCode - це запуски з “InlineCode " у назві стилю
Font - Горизонтальні правила-це абзаци з формою
HorizontalRule - Жирний акцент
- Виділено курсивом
- StrikeThrough форматування
- Списки являють собою пронумеровані або марковані абзаци
- Таблиці представлені за допомогою класу
Table - Посилання представлені у вигляді класу
FieldHyperlink
Наступний приклад показує, як створити документ з деякими стилями та зберегти його в Markdown:
Результат виконання цього прикладу коду показаний нижче.
Корисна порада
Є кілька нюансів і цікавих кейсів, дізнавшись які, ви зможете працювати з файлами Markdown більш гнучко і зручно. Наприклад, є можливість використовувати:
- SetextHeading це дозволяє створювати багаторядкові заголовки в Markdown, тоді як звичайні заголовки в Markdown можуть бути лише однорядковими. SetextHeading заснований на стилі “Заголовок N”, і його рівень може бути лише 1 або 2. Якщо N в " товарній позиції N “більше або дорівнює 2, то відповідний SetextHeading заснований на” Heading 2”, в іншому випадку - на"Heading 1”.
- Різні маркери для першого рівня маркованих списків ("-”, “+” або “*”, маркер за замовчуванням “-”.) та різні типи нумерації для упорядкованих списків ("." або “)”, маркер за замовчуванням “.").