---
title: "Преобразовать документ в Markdown в C#"
---

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

Markdown Он настолько популярен, что с ним легко работать, а также его можно довольно просто конвертировать в другие форматы. По этой причине, Aspose.Words Возможность конвертировать документ в [любой поддерживаемый формат загрузки](https://reference.aspose.com/words/net/aspose.words/loadformat/) то Markdown и наоборот - Aspose.Words Поддерживает самые популярные [Сохранить форматы](https://reference.aspose.com/words/net/aspose.words/saveformat/).

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

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

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

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

**.NET**
{{< gist "aspose-words-gists" "eacc4fc7407a98d683f3084bb86d58f7" "Examples-CSharp-Loading-and-Saving-ConvertDocumentToMarkdown-SaveAsMD.cs" >}}

Вы также можете указать физическую папку, в которой вы хотите сохранить изображения при экспорте документа. Markdown Формат. По умолчанию, Aspose.Words сохраняет изображения в той же папке, где сохранен файл документа, но вы можете отменить это поведение, используя [ImagesFolder](https://reference.aspose.com/words/net/aspose.words.saving/markdownsaveoptions/imagesfolder/) собственность.

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

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

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

**.NET**
{{< gist "aspose-words-gists" "eacc4fc7407a98d683f3084bb86d58f7" "Examples-CSharp-Loading-and-Saving-ConvertDocumentToMarkdown-SetImagesFolder.cs" >}}

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

Aspose.Words дает возможность использовать [MarkdownSaveOptions](https://reference.aspose.com/words/net/aspose.words.saving/markdownsaveoptions/) класс для работы с расширенными вариантами при сохранении документа на Markdown Формат. Большинство свойств наследуют или перегружают свойства, которые уже существуют в других. [Aspose.Words.Saving](https://reference.aspose.com/words/net/aspose.words.saving/) Классы пространства имен. Кроме того, ряд свойств, которые являются специфическими для Markdown Также добавлен формат. Например, в [TableContentAlignment](https://reference.aspose.com/words/net/aspose.words.saving/markdownsaveoptions/tablecontentalignment/) свойство контролировать выравнивание контента в таблицах, или [ImageSavingCallback](https://reference.aspose.com/words/net/aspose.words.saving/markdownsaveoptions/imagesavingcallback/) и [ImagesFolder](https://reference.aspose.com/words/net/aspose.words.saving/markdownsaveoptions/imagesfolder/) контролировать, как изображения сохраняются при преобразовании документа в Markdown Формат.

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

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

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

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

**.NET**
{{< gist "aspose-words-gists" "eacc4fc7407a98d683f3084bb86d58f7" "Examples-CSharp-Loading-and-Saving-ConvertDocumentToMarkdown-SupportedMarkdownFeatures.cs" >}}

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

![markdown-example-aspose-words-net](/words/net/convert-a-document-to-markdown/markdown-example.png)

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

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

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