Дар ҳаёти ҳаррӯзаи мо форматҳои гуногуни ҳуҷҷатҳо барои мақсадҳои гуногун истифода мешаванд. Markdown (MD) ба формати маъмул барои эҷоди мундариҷа барои вебсайтҳо, блогҳо ва дигар платформаҳои онлайн табдил ёфтааст. Аз тарафи дигар, Microsoft Word яке аз воситаҳои маъмултарини коркарди матн барои эҷод ва таҳрири ҳуҷҷатҳо мебошад. Аммо, вақте ки сухан дар бораи нашри мундариҷа дар интернет меравад, ҳуҷҷатҳои Word (DOC/DOCX) аз сабаби мураккабии форматкунии онҳо метавонанд беҳтарин интихоб набошанд. Дар ин ҷо табдил додани ҳуҷҷатҳои Word ба формати Markdown муфид аст. Дар ин мақола мо муҳокима хоҳем кард, ки чӣ тавр ҳуҷҷатҳои Wordро ба формати Markdown (MD) бо истифода аз C# ва REST API табдил додан мумкин аст.
Markdown интихоби маъмул барои эҷоди ҳуҷҷатҳо, махсусан барои навиштани техникӣ ва илмӣ мебошад, зеро он имкон медиҳад, ки матнро бе истифодаи абзорҳои мураккаби форматкунӣ осон созад.
Word ба API Conversion Markdown
Aspose.Words Cloud як API REST мебошад, ки ба таҳиягарон имкон медиҳад, ки вазифаҳои гуногуни коркарди ҳуҷҷатҳоро, аз қабили табдили Word ба Markdown иҷро кунанд. Бо ёрии Aspose.Words Cloud SDK for .NET, шумо метавонед ин API-ро дар барномаҳои .NET-и худ ба осонӣ истифода баред. Он роҳи содда ва муассири табдил додани ҳуҷҷатҳои Wordро ба формати Markdown пешниҳод мекунад, ки ба шумо имкон медиҳад, ки ба мантиқи асосии барномаи худ тамаркуз кунед.
Ҳоло, барои истифодаи SDK, лутфан Aspose.Words-Cloud
-ро дар менеҷери бастаҳои NuGet ҷустуҷӯ кунед ва тугмаи Иловаи бастаро пахш кунед. Сониян, маълумотномаи муштарии худро аз Cloud Dashboard гиред.
Агар шумо ҳисоби мавҷуда надошта бошед, танҳо бо истифода аз суроғаи почтаи электронии дуруст ҳисоби ройгон эҷод кунед.
Калом ба 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);
}
Дар зер тафсилот дар бораи ҳар як хати код оварда шудааст.
- Аввалан, мо як мисоли синфи Конфигуратсияро ҳангоми интиқоли ID муштарӣ ва маълумоти махфии муштарӣ ҳамчун далел эҷод кардем.
- Дуюм, объекти WordsApi эҷод кунед, ки дар он мо объекти Конфигуратсияро ҳамчун аргумент мегузорем.
- Сеюм, ҳуҷҷати воридшудаи 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 табдил дода, вақт ва кӯшиши арзишмандро дар раванди эҷоди мундариҷа сарфа кунанд.
Пайвандҳои муфид
Мақолаҳои марбут
Лутфан ба истиноди зерин муроҷиат кунед, то дар бораи маълумоти бештар маълумот гиред: