تحويل Markdown إلى PDF عبر Java باستخدام REST API

قم بتحويل ملفات Markdown إلى PDF في Java باستخدام REST API.

إذا كنت تعمل مع ملفات Markdown في مشروع Java الخاص بك وتحتاج إلى تحويلها إلى تنسيق PDF ، فإن GroupDocs.Conversion Cloud SDK for Java توفر طريقة بسيطة وفعالة للقيام بذلك. Markdown هي لغة ترميز خفيفة الوزن وبسيطة وسهلة الاستخدام يمكن استخدامها لإنشاء مستندات نصية منسقة بسرعة وكفاءة. من ناحية أخرى ، PDF هو تنسيق ملف يُستخدم لإنشاء المستندات ومشاركتها بطريقة تحافظ على تنسيق وتخطيط المستند الأصلي. ومع ذلك ، هناك أوقات تحتاج فيها إلى تحويل ملفات Markdown إلى PDF. في هذه المقالة ، سنشرح كيفية تحويل ملفات Markdown إلى PDF في Java باستخدام REST API.

سيتم تناول الموضوعات التالية في هذه المقالة:

Java API لتحويل Markdown إلى PDF وتثبيت SDK

تعد GroupDocs.Conversion Cloud SDK for Java مكتبة قوية تتيح للمستخدمين تحويل الملفات من وإلى تنسيقات مختلفة. تم تصميمه ليكون سهل الاستخدام ، ويوفر مجموعة واسعة من الميزات التي تجعله خيارًا مثاليًا للمطورين الذين يحتاجون إلى العمل مع الملفات في تنسيقات مختلفة. أصبح دمج API في التطبيقات المستندة إلى Java أمرًا بسيطًا وفعالًا ، مما يلغي الحاجة إلى برامج إضافية.

يمكنك إما تنزيل ملف JAR الخاص بواجهة برمجة التطبيقات أو تثبيته باستخدام Maven عن طريق إضافة المستودع التالي والتبعية إلى ملف pom.xml الخاص بمشروعك:

مستودع مافن:

<repository>
    <id>groupdocs-artifact-repository</id>
    <name>GroupDocs Artifact Repository</name>
    <url>https://repository.groupdocs.cloud/repo</url>
</repository>

تبعية المخضرم:

<dependency>
    <groupId>com.groupdocs</groupId
    <artifactId>groupdocs-conversion-cloud</artifactId>
    <version>23.4</version>
    <scope>compile</scope>
</dependency>

قبل أن تتمكن من استخدام GroupDocs.Conversion Cloud SDK لـ Java: ستحتاج إلى التسجيل لحساب GroupDocs للحصول على معرف العميل وسر العميل من لوحة القيادة. الرجاء إدخال مقتطف الرمز الموضح أدناه بمجرد حصولك على المعرف والسرية:

# احصل على client_id و client_secret من https://dashboard.groupdocs.cloud بعد التسجيل المجاني.

String ClientId = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx";
String ClientSecret = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx";
String MyStorage = "test-internal-storage";
Configuration configuration = new Configuration(ClientId, ClientSecret);

كيفية تحويل Markdown إلى PDF في Java باستخدام واجهة برمجة تطبيقات REST

لتحويل ملفات Markdown إلى مستندات PDF باستخدام GroupDocs.Conversion Cloud SDK for Java ، اتبع الخطوات التالية:

قم بتحميل الملف

بمجرد إعداد بيئة تحويل الملفات الخاصة بك ، يمكنك تحميل ملف Markdown إلى التخزين السحابي باستخدام مقتطف الشفرة الوارد أدناه:

package com.groupdocsdev.classes;

import com.groupdocs.cloud.conversion.api.*;
import com.groupdocs.cloud.conversion.model.*;
import com.groupdocs.cloud.conversion.model.requests.*;
import com.groupdocs.cloud.conversion.client.Configuration;
import com.groupdocs.cloud.conversion.client.ApiException;

import java.io.File;

// تحميل الملف إلى Cloud Storage باستخدام Java
public class App {

	public static void main(String[] args) {
				
		// إنشاء مثيل من تحويل API					
		FileApi apiInstance = new FileApi(configuration);
		try {
			File fileStream = new File("H:\\groupdocs-cloud-data\\input-sample-file.md");
			UploadFileRequest request = new UploadFileRequest("java-testing\\input-sample-file.md", fileStream, MyStorage);
			FilesUploadResult response = apiInstance.uploadFile(request);
			System.out.println("Expected response type is FilesUploadResult: " + response.getUploaded().size());
		} catch (ApiException e) {
			System.err.println("Exception while calling FileApi:");
			e.printStackTrace();
		}
		
	}
}

ومن ثم ، سيكون ملف Markdown الذي تم تحميله متاحًا في قسم الملفات من لوحة التحكم على السحابة.

تحويل ملف MD إلى تنسيق PDF

في هذا القسم ، سنقدم الخطوات ومثالًا لمقتطف الشفرة لتحويل ملفات MD إلى PDF في Java باستخدام GroupDocs.Conversion Cloud SDK for Java.

  • أولاً ، قم باستيراد الفئات المطلوبة إلى ملف Java الخاص بك.
  • ثانيًا ، قم بإنشاء مثيل لفئة ConvertApi.
  • ثالثًا ، قم بإنشاء مثيل لفئة ConvertSettings.
  • ثم قم بتوفير اسم التخزين السحابي.
  • بعد ذلك ، قم بتعيين مسار ملف Markdown للإدخال وتنسيق ملف الإخراج على “pdf”.
  • الآن ، قم بإنشاء مثيل لفئة PdfConvertOptions.
  • اختياريًا ، قم بتوفير خيارات تحويل متنوعة مثل setFromPage و setPagesCount و setMarginTop و setPassword و setCenterWindow و setHeight وما إلى ذلك.
  • بعد ذلك ، قم بتعيين خيارات التحويل ومسار ملف الإخراج باستخدام مثيل ConvertSettings.
  • بعد ذلك ، قم بإنشاء مثيل فئة ConvertDocumentRequest وتمرير معلمة الإعدادات.
  • أخيرًا ، قم باستدعاء الأسلوب convertDocument() وقم بتمرير المعلمة ConvertDocumentRequest.

يوضح مقتطف الشفرة التالي كيفية تحويل ملف MD إلى مستند PDF في Java باستخدام REST API:

package com.groupdocsdev.classes;

import com.groupdocs.cloud.conversion.api.*;
import com.groupdocs.cloud.conversion.model.*;
import com.groupdocs.cloud.conversion.model.requests.*;
import com.groupdocs.cloud.conversion.client.Configuration;
import com.groupdocs.cloud.conversion.client.ApiException;
import java.util.List;

// كيفية تحويل ملفات Markdown إلى PDF باستخدام Java
public class App {

	public static void main(String[] args) {
		
		// إنشاء مثيل من تحويل API
		ConvertApi apiInstance = new ConvertApi(configuration);
					
		try {
			 
			// تحضير إعدادات التحويل
			ConvertSettings settings = new ConvertSettings();
			settings.setStorageName(MyStorage);
			settings.setFilePath("java-testing/input-sample-file.md");
			settings.setFormat("pdf");
			
			PdfConvertOptions convertOptions = new PdfConvertOptions();
			convertOptions.setFromPage(1);
			convertOptions.setPagesCount(1);
			convertOptions.setZoom(50);
			convertOptions.setDpi(124.0);
			convertOptions.setCenterWindow(true);
			convertOptions.setCompressImages(false);
			convertOptions.setDisplayDocTitle(true);
			convertOptions.setFitWindow(false);
			convertOptions.setGrayscale(false);
			convertOptions.setImageQuality(100);
			convertOptions.setLinearize(false);
			convertOptions.setMarginTop(5);
			convertOptions.setMarginLeft(5);
			convertOptions.setPassword("password");
			convertOptions.setUnembedFonts(true);
			convertOptions.setRemoveUnusedStreams(true);
			convertOptions.setRemoveUnusedObjects(true);
			convertOptions.setRemovePdfaCompliance(false);
			convertOptions.setHeight(1024);
			 
			settings.setConvertOptions(convertOptions);
			settings.setOutputPath("java-testing/output-sample-file.pdf");
		
			// التحويل إلى التنسيق المحدد
			List<StoredConvertedResult> response = apiInstance.convertDocument(new ConvertDocumentRequest(settings));
			System.out.println("Document converted successfully: " + response);
			
		} catch (ApiException e) {
			System.err.println("Exception while calling Java API: ");
			e.printStackTrace();
		}
	}
}

هذا كل شيء! يمكنك أن ترى الإخراج في الصورة أدناه:

يقوم Java بتحويل ملف MD إلى PDF عبر الإنترنت

تحويل Markdown MD إلى ملف PDF بجافا.

قم بتنزيل الملف المحول

بعد اكتمال التحويل ، سيتم حفظ ملف الإخراج في مسار الإخراج على السحابة الذي حددته في كائن الإعدادات. يمكنك تنزيل ملف PDF المحول باستخدام مقتطف الشفرة التالي:

package com.groupdocsdev.classes;

import com.groupdocs.cloud.conversion.api.*;
import com.groupdocs.cloud.conversion.model.requests.*;
import com.groupdocs.cloud.conversion.client.Configuration;
import com.groupdocs.cloud.conversion.client.ApiException;

import java.io.File;

// قم بتنزيل الملف من Cloud Storage في Java
public class App {

	public static void main(String[] args) {
				
		// إنشاء مثيل من تحويل API					
		FileApi apiInstance = new FileApi(configuration);
		try {
			DownloadFileRequest request = new DownloadFileRequest("java-testing\\output-sample-file.pdf", MyStorage, null);
			File response = apiInstance.downloadFile(request);
			System.err.println("Expected response type is File: " + response.length());
		} catch (ApiException e) {
			System.err.println("Exception while calling FileApi:");
			e.printStackTrace();
		}
		
	}
}

Markdown على الإنترنت مجاني لتحويل PDF

كيفية تحويل Markdown إلى PDF عبر الإنترنت مجانًا؟ يرجى تجربة ملف MD عبر الإنترنت إلى PDF محول لإنشاء PDF من ملف Markdown MD. تم تطوير هذا المحول باستخدام Markdown to PDF REST API المذكورة أعلاه.

تلخيص لما سبق

في الختام ، أوضحت هذه المقالة مدى سهولة وكفاءة تحويل ملفات Markdown إلى تنسيق PDF باستخدام GroupDocs.Conversion Cloud SDK for Java. فيما يلي ما تعلمته من هذه المقالة:

  • كيفية تحويل MD إلى تنسيق PDF في Java برمجيًا ، بالإضافة إلى خيارات التخصيص الإضافية ؛
  • تحميل ملف MD برمجيًا إلى السحابة ثم تنزيل ملف PDF المحول من السحابة ؛
  • وقم بتحويل Markdown إلى PDF باستخدام ملف Markdown مجاني عبر الإنترنت إلى محول PDF.

بالإضافة إلى ذلك ، نقدم أيضًا قسم مرجع واجهة برمجة التطبيقات الذي يتيح لك تصور واجهات برمجة التطبيقات الخاصة بنا والتواصل معها مباشرةً من خلال المتصفح. شفرة المصدر الكاملة لـ Java SDK متاحة مجانًا على Github. يرجى التحقق من GroupDocs.Conversion Cloud SDK لـ Java أمثلة هنا.

علاوة على ذلك ، نقترح عليك اتباع دليل البدء لمعرفة الخطوات التفصيلية واستخدام واجهة برمجة التطبيقات.

أخيرًا ، نواصل كتابة مقالات مدونة جديدة حول تنسيقات وتحويلات ملفات مختلفة باستخدام REST API. لذا ، يرجى التواصل معنا للحصول على آخر التحديثات.

طرح سؤال

إذا كانت لديك أي أسئلة بخصوص Markdown إلى واجهة برمجة تطبيقات التحويل إلى PDF ، فالرجاء عدم التردد في الاتصال بنا على منتدى الدعم المجاني.

أسئلة وأجوبة

كيف أقوم بتحويل ملفات MD إلى PDF في Java؟

يمكنك تحويل MD إلى ملف PDF باستخدام GroupDocs.Conversion Cloud REST API for Java. إنها واجهة برمجة تطبيقات لتحويل المستندات قائمة على السحابة تتيح لك تحويل ملفات Markdown بسهولة إلى PDF باستخدام Java.

كيف يمكنني إعداد GroupDocs.Conversion Cloud SDK لـ Java في مشروعي؟

يمكنك إعداد GroupDocs.Conversion Cloud SDK for Java في مشروعك عن طريق إضافة SDK كعنصر تبعية في مشروع Java الخاص بك.

كيف يمكنني تحويل ملف Markdown إلى PDF عبر الإنترنت مجانًا؟

يسمح لك محول Markdown إلى PDF الخاص بنا بتحويل Markdown إلى تنسيق PDF مجانًا. يرجى اتباع التعليمات خطوة بخطوة الواردة أدناه لإجراء التحويل:

  • افتح محول MD إلى PDF المجاني عبر الإنترنت.
  • الآن ، انقر فوق منطقة إفلات الملف لتحميل Markdown أو سحب وإسقاط ملف Markdown.
  • بعد ذلك ، انقر فوق الزر “تحويل الآن”. سوف يقوم محول Markdown إلى PDF المجاني عبر الإنترنت بتغيير Markdown إلى PDF.
  • سيكون رابط تنزيل ملف PDF الناتج متاحًا بعد تحويل ملف MD.

كيفية تحويل ملفات Markdown إلى PDF على نظام Windows؟

يرجى زيارة هذا الرابط لتنزيل برنامج Markdown في وضع عدم الاتصال إلى محول PDF لنظام التشغيل Windows. يمكن استخدام هذا المحول لتحويل Markdown إلى ملفات PDF على Windows بسرعة ، بنقرة واحدة.

هل يمكنني تخصيص إخراج PDF عند تحويل ملفات Markdown إلى PDF؟

نعم ، يوفر GroupDocs.Conversion Cloud SDK for Java نطاقًا واسعًا من الخيارات والإعدادات التي تسمح لك بتخصيص إخراج PDF عند تحويل ملفات Markdown.

أنظر أيضا

إذا كنت ترغب في معرفة المزيد حول الموضوعات ذات الصلة ، نوصي بقراءة المقالات المدرجة أدناه: