Преобразование Markdown в DOCX – примеры C#

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

В этой статье содержится информация о том, как преобразовать Markdown в DOCX с помощью Aspose.HTML 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, вам может помочь следующий пример:

using System.IO;
using Aspose.Html.Converters;
using Aspose.Html.Saving;
...
    // 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 for converted file saving 
    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 с настраиваемыми параметрами сохранения:

using System.IO;
using Aspose.Html.Converters;
using Aspose.Html.Drawing;
using Aspose.Html.Saving;
...
    // 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 document
    using var document = Converter.ConvertMarkdown(sourcePath);

    // Initialize DocSaveOptions. Set up the page-size 600x400 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 HTML document to DOCX file format
    Converter.ConvertHTML(document, options, savePath);

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

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