Bu blog yazısı, dosya biçimi dönüştürme ve değiştirmeyle ilgili gerçek hayattaki bir soruna çözüm sunuyor. Doc/Docx‘ü MD’e dönüştürmeniz gereken birden fazla senaryo vardır; neyse ki GorupDocs.Conversion, Docx’ten Markdown’a dönüştürmeyi manuel ve programlı olarak gerçekleştirmenize olanak tanır. Ancak, Word’ü Markdown’a dönüştürmek için Bulut SDK’ları, [REST API’leri3 ve bir çevrimiçi aracı vardır ve bunların tümü GorupDocs.Conversion tarafından desteklenmektedir. Ayrıca basit API çağrıları yaparak kendi Markdown oluşturucunuzu oluşturabilirsiniz. Öyleyse başlayalım ve GorupDocs.Conversion Cloud SDK for .NET‘i kullanarak Word’ü C# dilinde Markdown’a programlı olarak nasıl dönüştüreceğimizi görelim.
Bu kılavuzda aşağıdaki bölümler açıklanmaktadır:
- Markdown Generator Kütüphane Kurulumu
- C#’ta Word’ü Programlı Olarak Markdown’a Dönüştürme
- Docx’i Markdown Online’a dönüştürün
Markdown Oluşturucu Kitaplığı Kurulumu
GorupDocs.Conversion Cloud SDK for .NET‘in kurulumu oldukça kolaydır ve kurulum prosedürü herhangi bir üçüncü taraf yazılımına bağlı değildir. Bu Docx’ten MD’ye dönüştürücü kitaplığını yüklemek için bu NuGet Paketi‘i indirin veya NuGet Paket Yöneticisinde aşağıdaki komutu çalıştırın.
Install-Package GroupDocs.Conversion-Cloud -Version 23.10.0
Dolayısıyla bir sonraki adım, API Bulutundan kontrol paneli API kimlik bilgilerini (İstemci Kimliği + İstemci Sırrı) almaktır. Tekrar ediyorum, bu çok kolaydır ve bunu birkaç saniye içinde yapabilirsiniz. API kimlik bilgilerini edinmede zorluk yaşamanız durumunda lütfen bu kılavuzu izleyin.
Programatik Olarak Word’ü C#’ta Markdown’a Dönüştürün
Bir .NET uygulamasında Docx’i MD’ye dönüştürmek için birkaç satır kod yazmaya başlamaya hazırız.
Not: API Cloud’umuza kontrol paneli bir kaynak Doc/Docx dosyası yükledik. Bununla birlikte, UploadFile yöntemini çağırarak manuel veya programlı olarak yükleme yapabilirsiniz.
Lütfen aşağıda belirtilen adımları izleyin:
- Client Secret & Client ID ile Configuration sınıfının bir örneğini oluşturun.
- API’nin temel URL’sini ayarlamak için ApiBaseUrl değerini tanımlayın.
- ConvertApi sınıfının bir nesnesini Configuration sınıfının nesnesiyle başlatın.
- ConvertSettings sınıfının bir örneğini oluşturun ve FilePath, Format vb. değerleri ayarlayarak bunu başlatın.
- Docx’i programlı olarak MD’ye dönüştürmek için ConvertDocument yöntemini çağırın ve ConvertDocumentRequest sınıfının bir örneğini iletin.
Aşağıdaki kod parçacığı, C# dilinde program aracılığıyla Word’den MD’ye nasıl dönüştürüleceğini gösterir:
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
{
// C#'ta Word'ü Markdown'a dönüştürün
class Convert_Docx_to_MD
{
static void Main(string[] args)
{
try
{
// API kimlik bilgilerinizi alın
string clientId = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx";
string clientSecret = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx";
string myStorage = "test";
// Client Secret & Client ID ile Configuration sınıfının bir örneğini oluşturun.
var configuration = new Configuration(clientId, clientSecret);
// API'nin temel URL'sini ayarlamak için ApiBaseUrl değerini tanımlayın.
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";
// ConvertApi sınıfının bir nesnesini Configuration sınıfının nesnesiyle başlatın.
var apiInstance = new ConvertApi(configuration);
// ConvertSettings sınıfının bir örneğini oluşturun ve FilePath, Format vb. değerleri ayarlayarak onu başlatın.
var settings = new ConvertSettings
{
FilePath = "sample.docx",
Format = "md",
OutputPath = "test/output-sample-file.md"
};
// ConvertDocument yöntemini çağırın ve Docx'i programlı olarak MD'ye dönüştürmek için ConvertDocumentRequest sınıfının bir örneğini iletin.
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);
}
}
}
}
Sunucuyu çalıştırdığınızda, API Bulutu’ndaki dashboard “test” klasöründe yeni bir MD dosyasının (yani çıktı-örnek-dosyası.md) oluşturulduğunu göreceksiniz. Böylece, DownloadFile yöntemini çağırarak dosyayı manuel veya programlı olarak indirebilirsiniz.
Docx’i Markdown Online’a dönüştürün
Şu ana kadar Word’ü C#’ta programlı olarak Markdown’a nasıl dönüştüreceğimizi öğrendik. Artık, GorupDocs.Conversion tarafından desteklenen bir çevrimiçi Docx’tan MD’ye dönüştürücüden yararlanabilirsiniz. Kullanımı kolaydır ve çok hoş bir sürükle ve bırak kullanıcı arayüzüyle birlikte gelir. Her şeyden önce, kullanımı ücretsiz olduğundan herhangi bir abonelik söz konusu değildir ve bu çevrimiçi aracı herhangi bir web tarayıcısında açabilirsiniz.
Son düşünceler
Bu bizi bu blog yazısının sonuna getiriyor. Word’ü programlı olarak C#’ta Markdown’a dönüştürmek için gereken adımları ve kod pasajını inceledik. Ayrıca, GorupDocs.Conversion Cloud SDK’ları tarafından desteklenen çevrimiçi Markdown oluşturucuyu da araştırdık. Ayrıca, diğer harika özellikler hakkında bilgi edinmek için belgeleri ziyaret edebilirsiniz. İş uygulamanız için Docx’ten MD’ye dönüştürücü geliştirmek istiyorsanız bu makale size yardımcı olacaktır. Ayrıca, bu proje açık kaynak olduğundan, burada canlı API’lerimizle ve ayrıca GitHub deposuyla etkileşime girmeyi unutmayın.
Ayrıca Başlangıç kılavuzumuzu takip etmenizi öneririz.
Son olarak groupdocs.cloud yeni blog yazıları yazıyor. Bu nedenle, düzenli güncellemeler için lütfen iletişim halinde kalın.
Bir soru sor
Sorularınızı veya sorularınızı forumumuzda bize bildirebilirsiniz.
Sıkça Sorulan Sorular – SSS
Bir Word belgesini Markdown’a nasıl dönüştürebilirim?
GorupDocs.Conversion Cloud SDK’ları kullanarak Doc/Docx’i Markdown’a dönüştürebilirsiniz. Adımları ve kod pasajını öğrenmek için lütfen bu bağlantı‘yı ziyaret edin.
Word’ü MD dosyasına dönüştürebilir miyiz?
Evet, GorupDocs.Conversion tarafından desteklenen bu çevrimiçi Fiyatlandırma oluşturucuyu kullanabilirsiniz. Ücretsizdir ve birkaç saniye içinde Word’ü MD’ye dönüştürür.