Convertir Markdown en PDF en Java

Markdown est un langage de balisage léger, et bien que Markdown soit un excellent outil pour écrire et structurer du contenu, il a des options de formatage limitées, n’est pas optimisé pour l’impression, etc. La conversion de Markdown en PDF vous permet de tirer parti du format PDF. Le format PDF présente de nombreux avantages et la conversion de Markdown en PDF peut être utilisée pour partager, formater, archiver ou imprimer des pages web. Dans cet article, vous trouverez des informations sur les scénarios de conversion Markdown vers PDF et apprendrez à utiliser PdfSaveOptions.

Note: Toute conversion de Markdown vers d’autres formats passe par l’étape de conversion de Markdown vers HTML.

Markdown vers PDF

Les méthodes statiques de la classe Converter sont principalement utilisées comme moyen le plus simple de convertir un fichier Markdown dans différents formats. Voyons les instructions pas à pas d’un scénario simple de conversion d’un fichier Markdown en PDF :

1. Charger un fichier Markdown. Vous pouvez charger un fichier Markdown à partir d’un fichier ou d’un flux. Dans l’exemple suivant, nous créons un fichier Markdown à partir de zéro.
2. Utilisez la méthode convertMarkdown(sourcePath) pour convertir un document Markdown en document HTML.
3. Créer un nouvel objet PdfSaveOptions.
4. Utilisez la méthode сonvertHTML(document, options, savePath) de la classe Converter pour enregistrer un document HTML intermédiaire en tant que fichier PDF. La méthode prend en paramètre document, options, et savePath et effectue la conversion.

Veuillez consulter l’extrait de code Java suivant, qui illustre le processus de conversion de Markdown en PDF avec des instructions étape par étape :

// 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");

Vous pouvez télécharger les exemples complets et les fichiers de données à partir de GitHub.

Options d’enregistrement – Classe PdfSaveOptions

Aspose.HTML for Java permet de convertir Markdown en PDF en utilisant des options d’enregistrement par défaut ou personnalisées. PdfSaveOptions vous permet de personnaliser le processus de rendu. Vous pouvez spécifier la taille des pages, les marges, les autorisations de fichiers, le type de média, 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.

Pour plus d’informations sur la personnalisation du processus de conversion avec PdfSaveOptions, vous pouvez vous référer à l’article Convertisseurs à réglage fin.

Convertir Markdown en PDF en utilisant PdfSaveOptions

Avec Aspose.HTML for Java, vous pouvez convertir des fichiers de manière programmatique en contrôlant totalement un large éventail de paramètres de conversion. L’exemple Java suivant montre comment utiliser PdfSaveOptions et créer un fichier PDF avec des résolutions, une couleur d’arrière-plan et une qualité Jpeg personnalisées :

1. Charger un fichier Markdown.
2. Convertir Markdown en HTML en utilisant l’une des méthodes convertMarkdown().
3. Créez un nouvel objet PdfSaveOptions et spécifiez les propriétés requises. Dans l’exemple suivant, nous appliquons une résolution, une qualité Jpeg et une couleur d’arrière-plan personnalisées au document PDF résultant :
   • Use the setHorizontalResolution() and VerticalResolution() methods to set horizontal and vertical resolutions for output PDF file.
   • Use the setBackgroundColor() method to set the color that fills the background.
   • Use the setJpegQuality method to specify the quality of JPEG compression for images.
4. Appeler la méthode сonvertHTML(document, options, savePath) de la classe Converter.

// Convert Markdown to HTML
HTMLDocument document = Converter.convertMarkdown("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");

Conclusion

Markdown est un langage de balisage simple et efficace, mais ses limitations en matière de formatage et d’optimisation pour l’impression soulignent la nécessité de convertir Markdown dans des formats plus universels tels que le PDF. Aspose.HTML for Java fournit une solution robuste pour la conversion de Markdown en PDF en utilisant une étape intermédiaire de traitement de Markdown en HTML. Grâce aux méthodes statiques de la classe Converter et aux PdfSaveOptions configurables, les développeurs disposent d’un contrôle total sur les options de conversion telles que les paramètres de page, la qualité des images, les couleurs d’arrière-plan, les résolutions, etc.

Aspose.HTML propose un Convertisseur Markdown en PDF en ligne gratuit qui convertit Markdown en PDF avec une grande qualité, facilement et rapidement. Il suffit de télécharger, de convertir vos fichiers et d’obtenir le résultat en quelques secondes !