Convertir Markdown a PDF en Java

Markdown es un lenguaje de marcado liviano y, si bien Markdown es una excelente herramienta para escribir y estructurar contenido, tiene opciones de formato limitadas, no está optimizado para impresión, etc. Convertir Markdown a PDF le permite aprovechar el formato PDF. PDF tiene muchos beneficios y la conversión de Markdown a PDF se puede utilizar para compartir, formatear, archivar o imprimir páginas web. En este artículo, encontrará información sobre escenarios de conversión de Markdown a PDF y aprenderá a utilizar PdfSaveOptions.

Nota: Cualquier conversión de Markdown a otros formatos pasa por la etapa de Conversión de Markdown a HTML.

Markdown a PDF

Los métodos estáticos de la clase Converter se utilizan principalmente como la forma más sencilla de convertir un archivo Markdown a varios formatos. Repasemos las instrucciones paso a paso para un escenario simple de conversión de Markdown a PDF:

1. Cargue un archivo Markdown. Puede cargar Markdown desde un archivo o secuencia. En el siguiente ejemplo, creamos Markdown desde cero.
2. Utilice el método convertMarkdown(sourcePath) para convertir Markdown a un documento HTML.
3. Cree un nuevo objeto PdfSaveOptions.
4. Utilice el método сonvertHTML(document, options, savePath) de la clase Converter para guardar un documento HTML intermedio como un archivo PDF. El método toma como parámetros document, options y savePath y realiza la conversión.

Revise el siguiente fragmento de código Java, que muestra el proceso de conversión de Markdown a PDF con instrucciones paso a paso:

// Prepare a simple Markdown example
String code = "### Hello, World! \n\n" +
        "[visit applications](https://products.aspose.app/html/applications)";

// Create a Markdown file
FileHelper.writeAllText("document.md", code);

// Convert Markdown to HTML
HTMLDocument document = Converter.convertMarkdown("document.md");

// Convert the HTML document to PDF file format
Converter.convertHTML(document, new PdfSaveOptions(), "document-output.pdf");

Puede descargar los ejemplos completos y los archivos de datos desde GitHub.

Opciones de guardado – Clase PdfSaveOptions

Aspose.HTML for Java permite convertir Markdown a PDF utilizando opciones de guardado predeterminadas o personalizadas. PdfSaveOptions le permite personalizar el proceso de renderizado. Puede especificar el tamaño de página, márgenes, permisos de archivo, tipo de medio, etc.

Metod	Description
setJpegQuality(value)	Specifies the quality of JPEG compression for images. The default value is 95.
getCss()	Gets a CssOptions object which is used for configuration of CSS properties processing.
setBackgroundColor(value)	Sets the color that will fill the background of every page. By default, this property is Transparent.
setPageSetup(value)	This method sets a page setup object and uses it for configuration output page-set.
setHorizontalResolution(value)	Sets horizontal resolution for internal images, in pixels per inch. By default this property is 300 dpi.
setVerticalResolution(value)	Sets vertical resolution for output images in pixels per inch. The default value is 300 dpi.
setEncryption	This method gets or sets encryption details. If it is not set, then no encryption will be performed.

Para obtener más información sobre cómo personalizar el proceso de conversión con PdfSaveOptions, puede consultar el artículo Convertidores de ajuste fino.

Convierta Markdown a PDF usando PdfSaveOptions

Con Aspose.HTML for Java, puede convertir archivos mediante programación con control total sobre una amplia gama de parámetros de conversión. El siguiente ejemplo de Java muestra cómo utilizar PdfSaveOptions y crear un archivo PDF con resoluciones personalizadas, color de fondo y JpegQuality:

1. Cargue un archivo Markdown.
2. Convierta Markdown a HTML usando uno de los métodos convertMarkdown().
3. Cree un nuevo objeto PdfSaveOptions y especifique las propiedades requeridas. En el siguiente ejemplo, aplicamos resoluciones personalizadas, JpegQuality y color de fondo para el documento PDF resultante:
   • Utilice los métodos setHorizontalResolution() y VerticalResolution() para establecer resoluciones horizontales y verticales para el archivo PDF de salida.
   • Utilice el método setBackgroundColor() para establecer el color que rellena el fondo.
   • Utilice el método setJpegQuality para especificar la calidad de la compresión JPEG de las imágenes.
4. Llame al método сonvertHTML(document, options, savePath) de la clase Converter.

// Convert Markdown to HTML
HTMLDocument document = Converter.convertMarkdown($i("nature.md"));

// Initialize PdfSaveOptions. Set up the resolutions, JpegQuality and change the background color to AliceBlue
PdfSaveOptions options = new PdfSaveOptions();
options.setHorizontalResolution(Resolution.to_Resolution(200));
options.setVerticalResolution(Resolution.to_Resolution(200));
options.setBackgroundColor(Color.getAliceBlue());
options.setJpegQuality(100);

// Convert the HTML document to PDF file format
Converter.convertHTML(document, options, "nature-output.pdf");

Conclusión

Markdown es un lenguaje de marcado simple y eficaz, pero sus limitaciones en el formato y la optimización para la impresión resaltan la necesidad de convertir Markdown a formatos más universales como PDF. Aspose.HTML for Java proporciona una solución sólida para convertir Markdown a PDF utilizando un paso intermedio de procesamiento de Markdown a HTML. Con métodos estáticos en la clase Converter y PdfSaveOptions configurables, los desarrolladores tienen control total sobre las opciones de conversión, como la configuración de la página, la calidad de la imagen, los colores de fondo, las resoluciones, etc.

Aspose.HTML ofrece un Convertidor de Markdown a PDF gratuito en línea que convierte Markdown a PDF con alta calidad, fácil y rápido. ¡Simplemente cargue, convierta sus archivos y obtenga el resultado en unos segundos!