Mūsų kasdieniame gyvenime įvairūs dokumentų formatai naudojami įvairiems tikslams. Markdown (MD) tapo populiariu svetainių, tinklaraščių ir kitų internetinių platformų turinio kūrimo formatu. Kita vertus, Microsoft Word yra viena iš plačiausiai naudojamų teksto apdorojimo įrankių kuriant ir redaguojant dokumentus. Tačiau kalbant apie turinio paskelbimą internete, „Word“ dokumentai (DOC/DOCX) gali būti ne geriausias pasirinkimas dėl jų formatavimo sudėtingumo. Čia naudinga konvertuoti Word dokumentus į Markdown formatą. Šiame straipsnyje aptarsime, kaip konvertuoti Word dokumentus į Markdown (MD) formatą naudojant C# ir REST API.
Markdown yra populiarus pasirinkimas kuriant dokumentus, ypač skirtus techniniam ir moksliniam rašymui, nes jis leidžia lengvai formatuoti tekstą nenaudojant sudėtingų formatavimo įrankių.
Word į Markdown konversijos API
Aspose.Words Cloud yra REST API, leidžianti kūrėjams atlikti įvairias dokumentų apdorojimo užduotis, pvz., konvertuoti Word į Markdown. Naudodami [Aspose.Words Cloud SDK, skirtą .NET] (https://products.aspose.cloud/words/net/), galite lengvai naudoti šią API savo .NET programose. Tai paprastas ir efektyvus būdas konvertuoti Word dokumentus į Markdown formatą, todėl galite sutelkti dėmesį į pagrindinę programos logiką.
Dabar, norėdami naudoti SDK, „NuGet“ paketų tvarkyklėje ieškokite „Aspose.Words-Cloud“ ir spustelėkite mygtuką Pridėti paketą. Antra, gaukite savo kliento kredencialus iš Cloud Dashboard.
Jei neturite paskyros, tiesiog sukurkite nemokamą paskyrą naudodami galiojantį el. pašto adresą.
Word į MD C#
Pabandykite naudoti šį kodo fragmentą, norėdami konvertuoti Word į MD naudodami C# .NET.
// Gaukite kliento kredencialus iš https://dashboard.aspose.cloud/
string clientSecret = "d757548a9f2558c39c2feebdf85b4c44";
string clientID = "4db2f826-bf9c-42e7-8b2a-8cbca2d15553";
// sukurti konfigūracijos objektą naudodami ClinetID ir Client Secret išsamią informaciją
var config = new Configuration { ClientId = clientID, ClientSecret = clientSecret };
// inicijuoti WordsApi egzempliorių
var wordsApi = new WordsApi(config);
// įvesti failo pavadinimą
String inputFile = "test_doc.docx";
// gauto failo pavadinimas
String resultant = "resultant.md";
// gautas failo formatas
String format = "MD";
try
{
// įkelkite failą iš vietinio disko
using (var file = System.IO.File.OpenRead(inputFile))
{
var uploadFileRequest = new UploadFileRequest(file, inputFile);
// įkelti failą į debesies saugyklą
wordsApi.UploadFile(uploadFileRequest);
}
// sukurti DocumentWithFormat užklausos objektą
var response = new GetDocumentWithFormatRequest(inputFile, format,outPath: resultant);
// suaktyvinti dokumento operaciją
wordsApi.GetDocumentWithFormat(response);
// spausdinti sėkmės pranešimą, jei konversija sėkminga
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);
}
Toliau pateikiama išsami informacija apie kiekvieną kodo eilutę.
- Pirma, mes sukūrėme konfigūracijos klasės egzempliorių, kaip argumentus perduodame kliento ID ir kliento paslapties kredencialus.
- Antra, sukurkite WordsApi objektą, kuriame kaip argumentą perduodame konfigūracijos objektą.
- Trečia, perskaitykite įvestą Word dokumentą iš vietinio disko ir įkelkite jį į debesies saugyklą naudodami UploadFile (…) metodą.
- Tada sukurkite GetDocumentWithFormatRequest egzempliorių, kuriame kaip argumentus perduodame įvesties failo pavadinimą, gautą formatą kaip MD ir gauto failo pavadinimą.
- Galiausiai iškvieskite GetDocumentWithFormat(..) metodą, kad atliktumėte Word į Markdown konvertavimą. Po konvertavimo gautas failas taip pat išsaugomas debesies saugykloje.
Pirmiau pateiktame pavyzdyje naudotą Word dokumento pavyzdį galima atsisiųsti iš testdoc.docx.
DOC į Markdown naudojant cURL komandas
Naudodami cURL komandas ir Aspose.Words Cloud, galite greitai ir lengvai konvertuoti Word dokumentus į Markdown formatą, nereikės rašyti jokio pasirinktinio kodo. Šis metodas leidžia sklandžiai integruoti su esamomis darbo eigomis ir įrankiais, taupant laiką ir pastangas. Taigi, naudojant cURL komandas ir Aspose.Words Cloud, Word konvertavimas į Markdown yra paprastas, efektyvus ir pritaikomas sprendimas jūsų dokumentų konvertavimo poreikiams.
Norėdami pradėti taikyti šį metodą, turime sugeneruoti prieigos prieigos raktą (pagal kliento kredencialus). Vykdykite šią komandą:
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"
Sugeneravę {accessToken}
, vykdykite šią komandą, kad įkeltumėte Word dokumentą iš saugyklos debesyje ir konvertuotumėte į Markdown (md) formatą. Naudojome parametrą -o, kuris išsaugo išvestį vietiniame diske.
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"
Išvada
Apibendrinant galima pasakyti, kad galimybė konvertuoti Word dokumentus į Markdown formatą gali labai supaprastinti turinio kūrimo procesą kūrėjams, tinklaraštininkams ir techniniams rašytojams. „Aspose.Words Cloud“ yra paprastas, bet galingas sprendimas šiai konversijai pasiekti, lanksčiai naudojant .NET SDK arba cURL komandas. Naudodami šį įrankį vartotojai gali lengvai konvertuoti savo Word dokumentus į Markdown formatą, sutaupydami brangaus laiko ir pastangų turinio kūrimo procese.
Naudingos nuorodos
susiję straipsniai
Norėdami sužinoti daugiau apie tai, apsilankykite šiose nuorodose: