Преобразование 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 для .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, вам может помочь следующий пример:

 1using System.IO;
 2using Aspose.Html.Converters;
 3using Aspose.Html.Saving;
 4...
 5    // Prepare a path to a source Markdown file
 6    string sourcePath = Path.Combine(OutputDir, "document.md");
 7
 8    // Prepare a simple Markdown example
 9    var code = "### Hello, World!" +
10               "\r\n" +
11               "Convert Markdown to DOCX!";
12    // Create a Markdown file
13    File.WriteAllText(sourcePath, code);
14    
15    // Prepare a path for converted file saving 
16    string savePath = Path.Combine(OutputDir, "document-output.docx");
17    
18    // Convert Markdown to HTML document
19    using var document = Converter.ConvertMarkdown(sourcePath);
20    
21    // Convert HTML document to DOCX file format
22    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 с настраиваемыми параметрами сохранения:

 1using System.IO;
 2using Aspose.Html.Converters;
 3using Aspose.Html.Drawing;
 4using Aspose.Html.Saving;
 5...
 6    // Prepare a path to a source Markdown file
 7    string sourcePath = Path.Combine(DataDir, "nature.md");
 8
 9    // Prepare a path for converted DOCX file saving 
10    string savePath = Path.Combine(OutputDir, "nature-output.docx");
11    
12    // Convert Markdown to HTML document
13    using var document = Converter.ConvertMarkdown(sourcePath);
14    
15    // Initialize DocSaveOptions. Set up the page-size 600x400 pixels and margins 
16    var options = new DocSaveOptions();
17    options.PageSetup.AnyPage = new Page(new Aspose.Html.Drawing.Size(500, 1000), new Margin(20, 20, 10, 10));
18    
19    // Convert HTML document to DOCX file format
20    Converter.ConvertHTML(document, options, savePath);

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

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

Text “Баннер Конвертера MD в DOCX”

Subscribe to Aspose Product Updates

Get monthly newsletters & offers directly delivered to your mailbox.