使用 REST API 通過 Java 將 Markdown 轉換為 PDF

使用 REST API 在 Java 中將 Markdown 文件轉換為 PDF。

如果您在 Java 項目中使用 Markdown 文件並需要將它們轉換為 PDF 格式,GroupDocs.Conversion Cloud SDK for Java 提供了一種簡單有效的方法來完成此操作。 Markdown 是一種輕量級、簡單易用的標記語言,可用於快速高效地創建格式化文本文檔。另一方面,PDF 是一種文件格式,用於以保留原始文檔的格式和佈局的方式創建和共享文檔。但是,有時您需要將 Markdown 文件轉換為 PDF。在本文中,我們將演示如何使用 REST API 在 Java 中將 Markdown 文件轉換為 PDF。

本文應涵蓋以下主題:

將 Markdown 轉換為 PDF 和 SDK 安裝的 Java API

GroupDocs.Conversion Cloud SDK for Java 是一個功能強大的庫,允許用戶將文件與不同格式相互轉換。它旨在易於使用,並提供廣泛的功能,使其成為需要處理各種格式文件的開發人員的理想選擇。將 API 集成到基於 Java 的應用程序變得簡單而高效,無需額外的軟件。

您可以 下載 API 的 JAR 文件或使用 Maven 安裝它,方法是將以下存儲庫和依賴項添加到項目的 pom.xml 文件中:

Maven 存儲庫:

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

Maven 依賴項:

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

在您可以使用 GroupDocs.Conversion Cloud SDK for Java 之前:您需要註冊 一個 GroupDocs 帳戶,以便從儀表板 獲取客戶端 ID 和客戶端密碼。獲得 ID 和 Secret 後,請輸入下面顯示的代碼段:

# 免費註冊後,從 https://dashboard.groupdocs.cloud 獲取您的 client_id 和 client_secret。

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

如何使用 REST API 在 Java 中將 Markdown 轉換為 PDF

要使用 GroupDocs.Conversion Cloud SDK for Java 將 Markdown 文件轉換為 PDF 文檔,請按照以下步驟操作:

  • 上傳 Markdown文件到雲端
  • 轉換 Java 中的 Markdown 轉 PDF 文件
  • 下載轉換後的文件

上傳文件

設置文件轉換環境後,您可以使用下面給出的代碼片段將 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;

// 使用 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 格式

在本節中,我們將提供使用 GroupDocs.Conversion Cloud SDK for Java 在 Java 中將 MD 文件轉換為 PDF 的步驟和示例代碼片段。

  • 首先,將所需的類導入到您的 Java 文件中。
  • 其次,創建 ConvertApi 類的實例。
  • 第三,創建 ConvertSettings 類的實例。
  • 然後,提供雲存儲名稱。
  • 接下來,將輸入的 Markdown 文件路徑和輸出文件格式設置為“pdf”。
  • 現在,創建 PdfConvertOptions 類的實例。
  • 或者,提供各種轉換選項,如 setFromPage、setPagesCount、setMarginTop、setPassword、setCenterWindow、setHeight 等。
  • 之後,使用 ConvertSettings 實例設置轉換選項和輸出文件路徑。
  • 然後,創建一個 ConvertDocumentRequest 類實例並傳遞設置參數。
  • 最後,調用 convertDocument() 方法並傳遞 ConvertDocumentRequest 參數。

以下代碼片段顯示瞭如何使用 REST API 在 Java 中將 MD 文件轉換為 PDF 文檔:

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;

// 如何使用 Java 將 Markdown 文件轉換為 PDF
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

在 Java 中將 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;

// 使用 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 轉換器 從 Markdown MD 文件創建 PDF。該轉換器是使用上述 Markdown to PDF REST API 開發的。

加起來

總之,本文展示了使用 GroupDocs.Conversion Cloud SDK for Java 將 Markdown 文件轉換為 PDF 格式是多麼簡單和高效。以下是您從本文中學到的內容:

  • 如何以編程方式將 MD 轉換為 PDF 格式,以及其他自定義選項;
  • 以編程方式將 MD 文件上傳到雲端,然後從雲端下載轉換後的 PDF;
  • 並使用免費的在線 Markdown 文件轉 PDF 轉換器將 Markdown 轉為 PDF。

此外,我們還提供了一個 API 參考 部分,讓您可以直接通過瀏覽器可視化我們的 API 並與之通信。 Java SDK 的完整源代碼可在 Github 上免費獲得。請查看 GroupDocs.Conversion Cloud SDK for Java 此處示例

此外,我們建議您按照我們的 入門指南 了解詳細步驟和 API 用法。

最後,我們繼續撰寫有關使用 REST API 的不同文件格式和轉換的新博客文章。因此,請聯繫以獲取最新更新。

問一個問題

如果您對 Markdown 到 PDF 轉換 API 有任何疑問,請隨時通過免費支持論壇 與我們聯繫。

常見問題

如何在 Java 中將 MD 文件轉換為 PDF?

您可以使用 GroupDocs.Conversion Cloud REST API for Java 將 MD 轉換為 PDF 文件。它是一個基於雲的文檔轉換 API,可讓您使用 Java 輕鬆地將 Markdown 文件轉換為 PDF。

如何在我的項目中設置 GroupDocs.Conversion Cloud SDK for Java?

您可以在項目中設置 GroupDocs.Conversion Cloud SDK for Java,方法是將 SDK 添加為 Java 項目中的依賴項。

如何免費在線將 Markdown 文件轉換為 PDF?

我們的 Markdown 到 PDF 轉換器允許您免費將 Markdown 轉換為 PDF 格式。請按照下面給出的分步說明執行轉換:

  • 打開免費的 MD 到 PDF 在線轉換器。
  • 現在,單擊文件放置區域以上傳 Markdown 或拖放 Markdown 文件。
  • 接下來,單擊立即轉換按鈕。免費的在線 Markdown 到 PDF 轉換器將 Markdown 轉換為 PDF。
  • 轉換 MD 文件後,輸出 PDF 的下載鏈接將可用。

如何在 Windows 上將 Markdown 文件轉換為 PDF?

請訪問 此鏈接 下載適用於 Windows 的離線 Markdown 到 PDF 轉換器。只需單擊一下,此轉換器可用於在 Windows 上快速將 Markdown 轉換為 PDF 文件。

將 Markdown 文件轉換為 PDF 時,我可以自定義 PDF 輸出嗎?

是的,GroupDocs.Conversion Cloud SDK for Java 提供了廣泛的選項和設置,允許您在轉換 Markdown 文件時自定義 PDF 輸出。

也可以看看

如果您想了解更多相關主題,我們建議您閱讀下面列出的文章: