Í daglegu lífi okkar eru ýmis skjalasnið notuð í mismunandi tilgangi. Markdown (MD) hefur orðið vinsælt snið til að búa til efni fyrir vefsíður, blogg og aðra netvettvanga. Aftur á móti er Microsoft Word eitt mest notaða ritvinnslutólið til að búa til og breyta skjölum. Hins vegar, þegar kemur að því að birta efni á netinu, eru Word skjöl (DOC/DOCX) kannski ekki besti kosturinn vegna þess hversu flókið snið þeirra er. Þetta er þar sem að breyta Word skjölum í Markdown snið kemur sér vel. Í þessari grein munum við ræða hvernig á að breyta Word skjölum í Markdown (MD) snið með því að nota C# og REST API.
Markdown er vinsæll kostur til að búa til skjöl, sérstaklega fyrir tæknilega og vísindalega skrif, þar sem það gerir kleift að forsníða texta án þess að þurfa að nota flókin sniðverkfæri.
Word to Markdown Conversion API
Aspose.Words Cloud er REST API sem gerir forriturum kleift að framkvæma ýmis skjalavinnsluverkefni eins og Word til Markdown umbreytingu. Með hjálp Aspose.Words Cloud SDK fyrir .NET geturðu auðveldlega notað þetta API í .NET forritunum þínum. Það býður upp á einfalda og skilvirka leið til að umbreyta Word skjölum í Markdown snið, sem gerir þér kleift að einbeita þér að kjarna forritsrökfræði þinni.
Nú, til að nota SDK, vinsamlegast leitaðu í Aspose.Words-Cloud
í NuGet pakkastjóranum og smelltu á Bæta við pakka hnappinn. Í öðru lagi, fáðu skilríki viðskiptavinar frá Cloud Dashboard.
Ef þú ert ekki með reikning sem fyrir er skaltu einfaldlega búa til ókeypis reikning með því að nota gilt netfang.
Orð til MD í C#
Vinsamlegast reyndu að nota eftirfarandi kóðabút til að breyta Word í MD með C# .NET.
// Fáðu skilríki viðskiptavina frá https://dashboard.aspose.cloud/
string clientSecret = "d757548a9f2558c39c2feebdf85b4c44";
string clientID = "4db2f826-bf9c-42e7-8b2a-8cbca2d15553";
// búa til stillingarhlut með því að nota ClinetID og Client Secret upplýsingar
var config = new Configuration { ClientId = clientID, ClientSecret = clientSecret };
// frumstilla WordsApi tilvik
var wordsApi = new WordsApi(config);
// innsláttarskráarheiti
String inputFile = "test_doc.docx";
// nafn skráar sem myndast
String resultant = "resultant.md";
// skráarsnið sem af því leiðir
String format = "MD";
try
{
// hlaðið skránni af staðbundnu drifi
using (var file = System.IO.File.OpenRead(inputFile))
{
var uploadFileRequest = new UploadFileRequest(file, inputFile);
// hlaða upp skrá í skýjageymslu
wordsApi.UploadFile(uploadFileRequest);
}
// búa til DocumentWithFormat beiðnihlut
var response = new GetDocumentWithFormatRequest(inputFile, format,outPath: resultant);
// kveikja á skjalaaðgerðinni
wordsApi.GetDocumentWithFormat(response);
// prentaðu árangursskilaboð ef umbreytingin heppnast
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);
}
Hér að neðan eru upplýsingar um hverja kóðalínu.
- Í fyrsta lagi höfum við búið til tilvik af stillingarflokki á meðan við sendum viðskiptavinaauðkenni og leyndarmál viðskiptavinar sem rök.
- Í öðru lagi, búðu til hlut af WordsApi þar sem við sendum Configuration object sem rök.
- Í þriðja lagi skaltu lesa innslátt Word skjalið af staðbundnu drifi og hlaða því upp í skýjageymslu með því að nota UploadFile(…) aðferðina.
- Búðu síðan til tilvik af GetDocumentWithFormatRequest þar sem við sendum innsláttarskráarnafnið, sniðið sem myndast sem MD og skráarnafnið sem myndast sem rök.
- Að lokum skaltu hringja í GetDocumentWithFormat(..) aðferðina til að framkvæma Word til Markdown umbreytingu. Eftir umbreytinguna er skráin sem myndast einnig vistuð í skýjageymslunni.
Hægt er að hlaða niður Word-skjalinu sem notað er í ofangreindu dæmi frá testdoc.docx.
DOC til Markdown með því að nota cURL skipanir
Með því að nota cURL skipanir og Aspose.Words Cloud, geturðu fljótt og auðveldlega umbreytt Word skjölum í Markdown snið án þess að þurfa að skrifa sérsniðinn kóða. Þessi nálgun gerir kleift að samþætta óaðfinnanlega við núverandi verkflæði og verkfæri, sem sparar tíma og fyrirhöfn. Svo, með því að nota cURL skipanir og Aspose.Words Cloud, fyrir Word til Markdown umbreytingu veitir einfalda, skilvirka og sérhannaðar lausn fyrir skjalabreytingarþarfir þínar.
Til að byrja með þessa nálgun þurfum við að búa til accessToken (byggt á skilríkjum viðskiptavinar). Vinsamlegast framkvæmið eftirfarandi skipun:
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"
Þegar {accessToken}
hefur verið búið til skaltu framkvæma eftirfarandi skipun til að hlaða Word skjal úr skýjageymslu og umbreyta í Markdown (md) snið. Við höfum notað -o breytu sem vistar úttakið á staðbundnu drifi.
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"
Niðurstaða
Að lokum, hæfileikinn til að umbreyta Word skjölum í Markdown snið getur einfaldað ferlið við að búa til efni til muna fyrir forritara, bloggara og tæknilega rithöfunda. Aspose.Words Cloud býður upp á einfalda en öfluga lausn til að ná þessari umbreytingu, með þeim sveigjanleika að nota annað hvort .NET SDK eða cURL skipanirnar. Með þessu tóli geta notendur auðveldlega umbreytt Word skjölum sínum í Markdown snið, sem sparar dýrmætan tíma og fyrirhöfn í efnissköpunarferlinu.
Gagnlegar hlekkir
tengdar greinar
Vinsamlegast farðu á eftirfarandi tengla til að læra meira um: