Преобразование Markdown в PDF через Java с использованием REST API

Преобразование файлов Markdown в PDF на Java с помощью REST API.

Если вы работаете с файлами Markdown в своем проекте Java и вам нужно преобразовать их в формат PDF, GroupDocs.Conversion Cloud SDK для Java предоставляет простой и эффективный способ сделать это. Markdown — это легкий, простой и удобный в использовании язык разметки, который можно использовать для быстрого и эффективного создания форматированных текстовых документов. С другой стороны, PDF – это формат файла, используемый для создания документов и обмена ими таким образом, чтобы сохранить форматирование и макет исходного документа. Однако бывают случаи, когда вам нужно преобразовать файлы Markdown в PDF. В этой статье мы покажем, как конвертировать файлы Markdown в PDF на Java с помощью REST API.

В этой статье должны быть раскрыты следующие темы:

Java API для преобразования Markdown в PDF и установки SDK

GroupDocs.Conversion Cloud SDK для Java — это мощная библиотека, которая позволяет пользователям преобразовывать файлы в различные форматы и из них. Он прост в использовании и предоставляет широкий спектр функций, что делает его идеальным выбором для разработчиков, которым необходимо работать с файлами в различных форматах. Интеграция API в приложения на основе Java стала простой и эффективной, устраняя необходимость в дополнительном программном обеспечении.

Вы можете либо скачать файл JAR API, либо установить его с помощью 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 API

Чтобы преобразовать файлы Markdown в документы PDF с помощью GroupDocs.Conversion Cloud SDK для 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;

// Загрузить файл в облачное хранилище с помощью 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 для Java.

  • Во-первых, импортируйте необходимые классы в ваш файл Java.
  • Во-вторых, создайте экземпляр класса ConvertApi.
  • В-третьих, создайте экземпляр класса ConvertSettings.
  • Затем укажите имя облачного хранилища.
  • Затем установите путь к входному файлу Markdown и формат выходного файла «pdf».
  • Теперь создайте экземпляр класса PdfConvertOptions.
  • При желании укажите различные параметры преобразования, такие как setFromPage, setPagesCount, setMarginTop, setPassword, setCenterWindow, setHeight и т. д.
  • После этого задайте параметры преобразования и путь к выходному файлу с помощью экземпляра ConvertSettings.
  • Затем создайте экземпляр класса ConvertDocumentRequest и передайте параметр settings.
  • Наконец, вызовите метод 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 на Java.

Загрузите преобразованный файл

После завершения преобразования выходной файл будет сохранен по выходному пути в облаке, который вы указали в объекте настроек. Вы можете загрузить преобразованный 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 конвертер, чтобы создать PDF из файла Markdown MD. Этот конвертер разработан с использованием вышеупомянутого REST API Markdown to PDF.

Подведение итогов

В заключение, эта статья продемонстрировала, насколько просто и эффективно конвертировать файлы Markdown в формат PDF с помощью GroupDocs.Conversion Cloud SDK для Java. Вот что вы узнали из этой статьи:

  • как конвертировать MD в формат PDF на Java программно, а также дополнительные возможности настройки;
  • программно загрузите файл MD в облако, а затем загрузите преобразованный PDF из облака;
  • и конвертируйте Markdown в PDF с помощью бесплатного онлайн-конвертера файлов Markdown в PDF.

Кроме того, мы также предоставляем раздел Справочник по API, который позволяет вам визуализировать и взаимодействовать с нашими API напрямую через браузер. Полный исходный код Java SDK находится в свободном доступе на Github. Пожалуйста, проверьте GroupDocs.Conversion Cloud SDK для Java Примеры здесь.

Кроме того, мы рекомендуем вам следовать нашему Руководству по началу работы для получения подробных инструкций и использования API.

Наконец, мы продолжаем писать новые статьи в блогах о различных форматах файлов и преобразованиях с использованием REST API. Поэтому, пожалуйста, свяжитесь с нами для получения последних обновлений.

Задайте вопрос

Если у вас есть какие-либо вопросы относительно API преобразования Markdown в PDF, не стесняйтесь обращаться к нам на бесплатный форум поддержки.

Часто задаваемые вопросы

Как преобразовать файлы MD в PDF в Java?

Вы можете преобразовать MD в файл PDF с помощью GroupDocs.Conversion Cloud REST API для Java. Это облачный API преобразования документов, который позволяет легко преобразовывать файлы Markdown в PDF с помощью Java.

Как настроить GroupDocs.Conversion Cloud SDK для Java в моем проекте?

Вы можете настроить GroupDocs.Conversion Cloud SDK для 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 для Java предоставляет широкий спектр параметров и настроек, позволяющих настраивать вывод PDF при преобразовании файлов Markdown.

Смотрите также

Если вы хотите узнать больше по связанным темам, мы рекомендуем прочитать статьи, перечисленные ниже: