Конвертировать Markdown в DOCX – примеры C#

Markdown – это язык разметки с синтаксисом форматирования простого текста. Markdown часто используется в качестве формата для документации и файлов readme, поскольку он позволяет писать в удобном для чтения и написания стиле. Его дизайн позволяет легко преобразовывать его во многие форматы вывода, но изначально он был создан для преобразования только в HTML. Используя библиотеку классов Aspose.HTML в своем приложении C#, вы можете легко преобразовать Markdown в файл DOCX, написав всего несколько строк кода!

В этой статье содержится информация о том, как преобразовать Markdown в DOCX с помощью Aspose.HTML for .NET API. Вы узнаете о поддерживаемых сценариях преобразования Markdown в DOCX и рассмотрите примеры C# для их иллюстрации. Кроме того, вы можете попробовать онлайн-конвертер Markdown, чтобы протестировать функциональность Aspose.HTML API и конвертировать Markdown на лету.

Онлайн Markdown Конвертер

Вы можете конвертировать Markdown в другие форматы с помощью Aspose.HTML for .NET API в режиме реального времени. Пожалуйста, загрузите файл Markdown из локальной файловой системы, выберите выходной формат и запустите пример. Параметры сохранения установлены по умолчанию. Вы сразу же получите результат конвертации в виде отдельного файла.

Если вы хотите программно преобразовать Markdown в DOCX, см. следующие примеры кода C#.

Конвертировать Markdown в DOCX на C#

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

1. Подготовьте исходный документ Markdown. В примере мы создаем файл Markdown из кода.
2. Подготовьте путь для сохранения преобразованного файла DOCX.
3. Конвертируйте Markdown в HTML. Используйте метод ConvertMarkdown(sourcePath), чтобы сохранить Markdown как документ HTML.
4. Используйте метод ConvertHTML(). Вам необходимо передать HTMLDocument, DocSaveOptions и путь к выходному файлу методу ConvertHTML() для преобразования HTML в DOCX.

Если вам нужно создать документ Markdown из пользовательской строки непосредственно в вашем коде и преобразовать его в файл DOCX, вам может помочь следующий пример:

// Prepare a path to a source Markdown file
string sourcePath = Path.Combine(OutputDir, "document.md");

// Prepare a simple Markdown example
var code = "### Hello, World!" +
           "\r\n" +
           "Convert Markdown to DOCX!";

// Create a Markdown file
File.WriteAllText(sourcePath, code);

// Prepare a path to save the converted file
string savePath = Path.Combine(OutputDir, "document-output.docx");

// Convert Markdown to HTML document
using var document = Converter.ConvertMarkdown(sourcePath);

// Convert HTML document to DOCX file format
Converter.ConvertHTML(document, new DocSaveOptions(), savePath);

Вы можете скачать полные примеры и файлы данных с GitHub.

Конвертировать Markdown в DOCX с использованием DocSaveOptions

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

1. Откройте существующий документ Markdown. В примере мы загружаем файл Markdown из локальной файловой системы ( nature.md).
2. Подготовьте путь для сохранения преобразованного файла DOCX.
3. Конвертируйте Markdown в HTML. Используйте метод ConvertMarkdown(sourcePath) класса Converter, чтобы сохранить Markdown как документ HTML.
4. Создайте новый объект DocSaveOptions и укажите необходимые свойства.
5. Используйте метод ConvertHTML(). Вам необходимо передать HTMLDocument, PdfSaveOptions и путь к выходному файлу методу ConvertHTML().

В следующем фрагменте кода показано, как преобразовать Markdown в DOCX с настраиваемыми параметрами сохранения:

// Prepare a path to a source Markdown file
string sourcePath = Path.Combine(DataDir, "nature.md");

// Prepare a path for converted DOCX file saving 
string savePath = Path.Combine(OutputDir, "nature-output.docx");

// Convert Markdown to HTML 
using var document = Converter.ConvertMarkdown(sourcePath);

// Initialize DocSaveOptions. Set up the page-size 500x1000 pixels and margins 
var options = new DocSaveOptions();
options.PageSetup.AnyPage = new Page(new Aspose.Html.Drawing.Size(500, 1000), new Margin(20, 20, 10, 10));

// Convert the HTML document to DOCX file format
Converter.ConvertHTML(document, options, savePath);

Класс DocSaveOptions предоставляет свойства, которые дают вам полный контроль над широким диапазоном параметров и улучшают процесс преобразования Markdown в формат DOCX. В примере мы используем свойство PageSetup, которое указывает размер страницы документа DOCX. Чтобы узнать больше о DocSaveOptions, прочитайте статью Fine-Tuning Converters.

Aspose.HTML предлагает бесплатный онлайн Конвертер MD в DOCX, который конвертирует файлы Markdown в DOCX с высоким качеством, просто и быстро. Просто загрузите, конвертируйте свои файлы и получите результат за несколько секунд!