Convierta Markdown a PDF a través de Java usando REST API

Convierta archivos Markdown a PDF en Java utilizando la API REST.

Si está trabajando con archivos Markdown en su proyecto de Java y necesita convertirlos a formato PDF, GroupDocs.Conversion Cloud SDK para Java proporciona una manera simple y eficiente de hacerlo. Markdown es un lenguaje de marcado ligero, simple y fácil de usar que se puede usar para crear documentos de texto formateados de manera rápida y eficiente. Por otro lado, PDF es un formato de archivo que se utiliza para crear y compartir documentos de una manera que conserva el formato y el diseño del documento original. Sin embargo, hay ocasiones en las que necesita convertir sus archivos Markdown a PDF. En este artículo, demostraremos cómo convertir archivos Markdown a PDF en Java utilizando la API REST.

En este artículo se tratarán los siguientes temas:

API de Java para convertir Markdown a PDF e instalación de SDK

GroupDocs.Conversion Cloud SDK for Java es una potente biblioteca que permite a los usuarios convertir archivos desde y hacia diferentes formatos. Está diseñado para ser fácil de usar y proporciona una amplia gama de características que lo convierten en una opción ideal para los desarrolladores que necesitan trabajar con archivos en varios formatos. La integración de la API en aplicaciones basadas en Java se hace simple y eficiente, eliminando la necesidad de software adicional.

Puede descargar el archivo JAR de la API o instalarlo usando Maven agregando el siguiente repositorio y dependencia en el archivo pom.xml de su proyecto:

Repositorio Maven:

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

Dependencia Maven:

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

Antes de poder usar GroupDocs.Conversion Cloud SDK para Java: deberá registrarse para obtener una cuenta de GroupDocs para obtener el ID de cliente y el secreto del cliente del panel. Ingrese el fragmento de código que se muestra a continuación una vez que tenga su ID y secreto:

# Obtenga su client_id y client_secret de https://dashboard.groupdocs.cloud después del registro gratuito.

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

Cómo convertir Markdown a PDF en Java usando la API REST

Para convertir archivos Markdown a documentos PDF usando GroupDocs.Conversion Cloud SDK para Java, siga los pasos a continuación:

Sube el archivo

Una vez que haya configurado su entorno de conversión de archivos, puede cargar el archivo Markdown en el almacenamiento en la nube utilizando el fragmento de código que se proporciona a continuación:

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;

// Subir archivo al almacenamiento en la nube usando Java
public class App {

	public static void main(String[] args) {
				
		// Crear una instancia de la API de conversión					
		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();
		}
		
	}
}

Por lo tanto, el archivo Markdown cargado estará disponible en la sección de archivos de su tablero en la nube.

Convertir archivo MD a formato PDF

En esta sección, proporcionaremos los pasos y un fragmento de código de ejemplo para convertir archivos MD a PDF en Java usando GroupDocs.Conversion Cloud SDK para Java.

  • En primer lugar, importe las clases requeridas en su archivo Java.
  • En segundo lugar, cree una instancia de la clase ConvertApi.
  • En tercer lugar, cree una instancia de la clase ConvertSettings.
  • Luego, proporcione el nombre de almacenamiento en la nube.
  • A continuación, establezca la ruta del archivo Markdown de entrada y el formato del archivo de salida en “pdf”.
  • Ahora, cree una instancia de la clase PdfConvertOptions.
  • Opcionalmente, proporcione varias opciones de conversión como setFromPage, setPagesCount, setMarginTop, setPassword, setCenterWindow, setHeight, etc.
  • Después de eso, configure las opciones de conversión y la ruta del archivo de salida usando la instancia de ConvertSettings.
  • Luego, cree una instancia de clase ConvertDocumentRequest y pase el parámetro de configuración.
  • Por último, llame al método convertDocument() y pase el parámetro ConvertDocumentRequest.

El siguiente fragmento de código muestra cómo convertir un archivo MD en un documento PDF en Java utilizando la API REST:

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;

// Cómo convertir archivos Markdown a PDF usando Java
public class App {

	public static void main(String[] args) {
		
		// Crear una instancia de la API de conversión
		ConvertApi apiInstance = new ConvertApi(configuration);
					
		try {
			 
			// Preparar la configuración de conversión
			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");
		
			// convertir al formato especificado
			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();
		}
	}
}

¡Eso es todo! Puedes ver la salida en la siguiente imagen:

Java convierte archivos MD a PDF en línea

Convierta Markdown MD a archivo PDF en Java.

Descargar el archivo convertido

Una vez completada la conversión, el archivo de salida se guardará en la ruta de salida en la nube que especificó en el objeto de configuración. Puede descargar el archivo PDF convertido usando el siguiente fragmento de código:

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;

// Descargar archivo desde el almacenamiento en la nube en Java
public class App {

	public static void main(String[] args) {
				
		// Crear una instancia de la API de conversión					
		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();
		}
		
	}
}

Convertidor en línea gratuito de Markdown a PDF

¿Cómo convertir Markdown a PDF en línea de forma gratuita? Pruebe un archivo MD en línea a PDF convertidor para crear un PDF a partir de un archivo Markdown MD. Este convertidor se desarrolla utilizando la API REST de Markdown a PDF mencionada anteriormente.

Resumiendo

En conclusión, este artículo ha demostrado lo fácil y eficiente que es convertir archivos Markdown a formato PDF utilizando GroupDocs.Conversion Cloud SDK para Java. Lo siguiente es lo que has aprendido de este artículo:

  • cómo convertir formato MD a PDF en Java mediante programación, así como opciones de personalización adicionales;
  • cargue mediante programación el archivo MD en la nube y luego descargue el PDF convertido desde la nube;
  • y convierta Markdown a PDF utilizando un convertidor gratuito en línea de archivos Markdown a PDF.

Además, también proporcionamos una sección Referencia de API que le permite visualizar y comunicarse con nuestras API directamente a través del navegador. El código fuente completo de Java SDK está disponible gratuitamente en Github. Consulte GroupDocs.Conversion Cloud SDK para Java Ejemplos aquí.

Además, le sugerimos que siga nuestra Guía de introducción para conocer los pasos detallados y el uso de la API.

Finalmente, seguimos escribiendo nuevos artículos de blog sobre diferentes formatos de archivo y conversiones utilizando la API REST. Por lo tanto, póngase en contacto para obtener las últimas actualizaciones.

Hacer una pregunta

Si tiene alguna pregunta sobre la API de conversión de Markdown a PDF, no dude en comunicarse con nosotros en el foro de soporte gratuito.

preguntas frecuentes

¿Cómo convierto archivos MD a PDF en Java?

Puede convertir MD a un archivo PDF usando GroupDocs.Conversion Cloud REST API for Java. Es una API de conversión de documentos basada en la nube que le permite convertir fácilmente archivos Markdown a PDF usando Java.

¿Cómo configuro GroupDocs.Conversion Cloud SDK para Java en mi proyecto?

Puede configurar GroupDocs.Conversion Cloud SDK for Java en su proyecto agregando el SDK como una dependencia en su proyecto Java.

¿Cómo puedo convertir un archivo Markdown a PDF en línea de forma gratuita?

Nuestro convertidor de Markdown a PDF le permite convertir Markdown a formato PDF de forma gratuita. Siga las instrucciones paso a paso que se dan a continuación para realizar la conversión:

  • Abra el conversor gratuito de MD a PDF en línea.
  • Ahora, haga clic en el área de colocación de archivos para cargar un Markdown o arrastre y suelte un archivo Markdown.
  • A continuación, haga clic en el botón Convertir ahora. El convertidor en línea gratuito de Markdown a PDF cambiará Markdown a PDF.
  • El enlace de descarga del PDF de salida estará disponible después de convertir el archivo MD.

¿Cómo convertir archivos Markdown a PDF en Windows?

Visite este enlace para descargar un convertidor de Markdown a PDF sin conexión para Windows. Este convertidor se puede utilizar para convertir archivos Markdown a PDF en Windows rápidamente, con un solo clic.

¿Puedo personalizar la salida de PDF al convertir archivos Markdown a PDF?

Sí, GroupDocs.Conversion Cloud SDK for Java proporciona una amplia gama de opciones y configuraciones que le permiten personalizar la salida PDF al convertir archivos Markdown.

Ver también

Si desea obtener más información sobre temas relacionados, le recomendamos leer los artículos que se enumeran a continuación: