У нашому повсякденному житті різні формати документів використовуються для різних цілей. Markdown (MD) став популярним форматом для створення контенту для веб-сайтів, блогів та інших онлайн-платформ. З іншого боку, Microsoft Word є одним із найбільш широко використовуваних інструментів обробки текстів для створення та редагування документів. Однак, коли мова заходить про публікацію вмісту в Інтернеті, документи Word (DOC/DOCX) можуть бути не найкращим вибором через складність форматування. Тут стане в нагоді конвертація документів Word у формат Markdown. У цій статті ми обговоримо, як конвертувати документи Word у формат Markdown (MD) за допомогою C# і REST API.
Markdown є популярним вибором для створення документів, особливо для технічного та наукового написання, оскільки він дозволяє легко форматувати текст без використання складних інструментів форматування.
Word to Markdown Conversion API
Aspose.Words Cloud — це REST API, який дозволяє розробникам виконувати різноманітні завдання обробки документів, як-от перетворення Word у Markdown. За допомогою Aspose.Words Cloud SDK для .NET ви можете легко використовувати цей API у своїх програмах .NET. Він пропонує простий і ефективний спосіб конвертувати документи Word у формат Markdown, дозволяючи вам зосередитися на основній логіці програми.
Тепер, щоб використовувати SDK, виконайте пошук Aspose.Words-Cloud
в менеджері пакетів NuGet і натисніть кнопку «Додати пакет». По-друге, отримайте облікові дані клієнта з Cloud Dashboard.
Якщо у вас немає облікового запису, просто створіть безкоштовний обліковий запис, використовуючи дійсну адресу електронної пошти.
Word to MD на C#
Спробуйте використати наведений нижче фрагмент коду, щоб перетворити Word на MD за допомогою C# .NET.
// Отримайте облікові дані клієнта з https://dashboard.aspose.cloud/
string clientSecret = "d757548a9f2558c39c2feebdf85b4c44";
string clientID = "4db2f826-bf9c-42e7-8b2a-8cbca2d15553";
// створити об’єкт конфігурації, використовуючи дані ClinetID і Client Secret
var config = new Configuration { ClientId = clientID, ClientSecret = clientSecret };
// ініціалізувати екземпляр WordsApi
var wordsApi = new WordsApi(config);
// ім'я вхідного файлу
String inputFile = "test_doc.docx";
// ім'я отриманого файлу
String resultant = "resultant.md";
// результуючий формат файлу
String format = "MD";
try
{
// завантажити файл з локального диска
using (var file = System.IO.File.OpenRead(inputFile))
{
var uploadFileRequest = new UploadFileRequest(file, inputFile);
// завантажити файл у хмарне сховище
wordsApi.UploadFile(uploadFileRequest);
}
// створити об’єкт запиту DocumentWithFormat
var response = new GetDocumentWithFormatRequest(inputFile, format,outPath: resultant);
// запустити операцію з документом
wordsApi.GetDocumentWithFormat(response);
// надрукувати повідомлення про успішне завершення, якщо перетворення виконано успішно
if (response != null && response.Equals("OK"))
{
Console.WriteLine("Word to Markdown conversion successfull !");
Console.ReadKey();
}
}catch (Exception ex)
{
Console.WriteLine("error:" + ex.Message + "\n" + ex.StackTrace);
}
Нижче наведено подробиці про кожен рядок коду.
- По-перше, ми створили екземпляр класу конфігурації, передаючи облікові дані клієнта та секрет клієнта як аргументи.
- По-друге, створіть об’єкт WordsApi, де ми передаємо Configuration object як аргумент.
- По-третє, прочитайте вхідний документ Word із локального диска та завантажте його в хмарне сховище за допомогою методу UploadFile(…).
- Потім створіть екземпляр GetDocumentWithFormatRequest, де ми передаємо назву вхідного файлу, результуючий формат як MD і результуючу назву файлу як аргументи.
- Нарешті, викличте метод GetDocumentWithFormat(..), щоб виконати перетворення Word у Markdown. Після перетворення отриманий файл також зберігається в хмарному сховищі.
Зразок документа Word, використаний у наведеному вище прикладі, можна завантажити з testdoc.docx.
DOC у Markdown за допомогою команд cURL
Використовуючи команди cURL і Aspose.Words Cloud, ви можете швидко й легко конвертувати документи Word у формат Markdown без необхідності писати будь-який спеціальний код. Такий підхід забезпечує повну інтеграцію з існуючими робочими процесами та інструментами, заощаджуючи час і зусилля. Отже, використання команд cURL і Aspose.Words Cloud для перетворення Word у Markdown забезпечує просте, ефективне та настроюване рішення для ваших потреб у перетворенні документів.
Щоб почати використовувати цей підхід, нам потрібно згенерувати accessToken (на основі облікових даних клієнта). Будь ласка, виконайте таку команду:
curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=bb959721-5780-4be6-be35-ff5c3a6aa4a2&client_secret=4d84d5f6584160cbd91dba1fe145db14" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"
Після створення {accessToken}
виконайте наступну команду, щоб завантажити документ Word із хмарного сховища та конвертувати у формат Markdown (md). Ми використали параметр -o, який зберігає вихідні дані на локальному диску.
curl -v "https://api.aspose.cloud/v4.0/words/test_doc.docx?format=MD" \
-X GET \
-H "accept: application/octet-stream" \
-H "Authorization: Bearer <accessToken>" \
-o "resultant.md"
Висновок
Підсумовуючи, можливість конвертувати документи Word у формат Markdown може значно спростити процес створення вмісту для розробників, блогерів і технічних авторів. Aspose.Words Cloud надає просте, але потужне рішення для досягнення цього перетворення з гнучкістю використання команд .NET SDK або cURL. За допомогою цього інструменту користувачі можуть легко конвертувати свої документи Word у формат Markdown, заощаджуючи дорогоцінний час і зусилля в процесі створення вмісту.
корисні посилання
Схожі статті
Перейдіть за наведеними нижче посиланнями, щоб дізнатися більше про: