В этом сообщении блога вы найдете решение реальной проблемы, связанной с преобразованием формата файла и манипулированием им. Существует несколько сценариев, в которых вам необходимо преобразовать Doc/Docx в MD, к счастью, GorupDocs.Conversion позволяет выполнять преобразование Docx в Markdown вручную, а также программно. Однако существуют Cloud SDK, REST API и онлайн инструмент для преобразования Word в Markdown, и все они основаны на GorupDocs.Conversion. Кроме того, вы можете создать свой собственный генератор Markdown, выполнив простые вызовы API. Итак, давайте начнем и посмотрим, как программно преобразовать Word в Markdown на C# с помощью GorupDocs.Conversion Cloud SDK для .NET.
В этом руководстве рассматриваются следующие разделы:
- Установка библиотеки генератора Markdown
- Преобразование Word в Markdown в C# программно
- Конвертировать Docx в Markdown онлайн
Установка библиотеки генератора Markdown
GorupDocs.Conversion Cloud SDK для .NET довольно легко установить, и процедура его установки не зависит от какого-либо стороннего программного обеспечения. Чтобы установить эту библиотеку конвертера Docx в MD, загрузите этот Пакет NuGet или выполните следующую команду в диспетчере пакетов NuGet.
Install-Package GroupDocs.Conversion-Cloud -Version 23.10.0
Итак, следующим шагом будет получение учетных данных API (идентификатор клиента + секрет клиента) из облака API панель мониторинга. Опять же, это очень просто, и вы можете сделать это за несколько секунд. Следуйте этому руководству на случай, если у вас возникнут какие-либо трудности с получением учетных данных API.
Программное преобразование Word в Markdown в C#
Все готово для того, чтобы начать писать несколько строк кода для преобразования Docx в MD в приложении .NET.
Примечание. Мы загрузили исходный файл Doc/Docx в наше облако API панель управления. Тем не менее, вы можете загрузить вручную или программно, вызвав метод UploadFile.
Пожалуйста, следуйте инструкциям ниже:
- Создайте экземпляр класса Configuration с секретом клиента и идентификатором клиента.
- Определите значение ApiBaseUrl, чтобы установить базовый URL-адрес API.
- Инициализируйте объект класса ConvertApi объектом класса Configuration.
- Создайте экземпляр класса ConvertSettings и инициализируйте его, задав такие значения, как FilePath, Format и т. д.
- Вызовите метод ConvertDocument и передайте экземпляр класса ConvertDocumentRequest для программного преобразования Docx в MD.
В следующем фрагменте кода показано, как программно преобразовать Word в MD на C#:
using System;
using GroupDocs.Conversion.Cloud.Sdk.Api;
using GroupDocs.Conversion.Cloud.Sdk.Client;
using GroupDocs.Conversion.Cloud.Sdk.Model.Requests;
using System.IO;
using GroupDocs.Conversion.Cloud.Sdk.Model;
namespace GroupDocs.Conversion.CSharp
{
// Преобразование Word в Markdown в C#
class Convert_Docx_to_MD
{
static void Main(string[] args)
{
try
{
// Получите учетные данные API
string clientId = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx";
string clientSecret = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx";
string myStorage = "test";
// Создайте экземпляр класса Configuration с секретом клиента и идентификатором клиента.
var configuration = new Configuration(clientId, clientSecret);
// Определите значение ApiBaseUrl, чтобы установить базовый URL-адрес API.
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";
// Инициализируйте объект класса ConvertApi с помощью объекта класса Configuration.
var apiInstance = new ConvertApi(configuration);
// Создайте экземпляр класса ConvertSettings и инициализируйте его, задав такие значения, как FilePath, Format и т. д.
var settings = new ConvertSettings
{
FilePath = "sample.docx",
Format = "md",
OutputPath = "test/output-sample-file.md"
};
// Вызовите метод ConvertDocument и передайте экземпляр класса ConvertDocumentRequest, чтобы программно преобразовать Docx в MD.
var response = apiInstance.ConvertDocument(new ConvertDocumentRequest(settings));
Console.WriteLine("Successfully converted Docx to Markdown in C#: " + response[0].Url);
}
catch (Exception e)
{
Console.WriteLine("Exception when calling GroupDocs Api: " + e.Message);
}
}
}
}
После запуска сервера вы увидите новый файл MD (т. е. выходной файл-образец.md), созданный в папке «test» в облаке API панель управления. Таким образом, вы можете загрузить файл вручную или программно, вызвав метод DownloadFile.
Конвертируйте Docx в Markdown онлайн
На данный момент мы узнали, как программно конвертировать Word в Markdown на C#. Теперь вы можете использовать онлайн конвертер Docx в MD, поддерживаемый GorupDocs.Conversion. Он прост в использовании и имеет очень приятный интерфейс с возможностью перетаскивания. Прежде всего, здесь не требуется подписки, поскольку его можно использовать бесплатно, и вы можете открыть этот онлайн-инструмент в любом веб-браузере.
Последние мысли
Это подводит нас к концу этого поста в блоге. Мы рассмотрели шаги и фрагмент кода для программного преобразования Word в Markdown на C#. Кроме того, мы также изучили онлайн-генератор Markdown на базе GorupDocs.Conversion Cloud SDK. Кроме того, вы можете посетить документацию, чтобы узнать о других интересных функциях. Эта статья поможет вам, если вы хотите разработать конвертер Docx в MD для своего бизнес-приложения. Кроме того, не забывайте взаимодействовать с нашими действующими API здесь, а также с репозиторием GitHub, поскольку этот проект имеет открытый исходный код.
Кроме того, мы рекомендуем вам следовать нашему руководству по началу работы.
Наконец, groupdocs.cloud пишет новые сообщения в блоге. Поэтому, пожалуйста, оставайтесь на связи для получения регулярных обновлений.
Задайте вопрос
Вы можете сообщить нам о своих вопросах или пожеланиях на нашем форуме.
Часто задаваемые вопросы – Часто задаваемые вопросы
Как преобразовать документ Word в Markdown?
Вы можете конвертировать Doc/Docx в Markdown с помощью GorupDocs.Conversion Cloud SDK. Посетите эту ссылку, чтобы изучить шаги и фрагмент кода.
Можем ли мы конвертировать Word в файл MD?
Да, вы можете использовать этот онлайн генератор Markdown на базе GorupDocs.Conversion. Он бесплатен и конвертирует Word в MD за несколько секунд.