Convertir Markdown en image avec Aspose.HTML for Java – PNG, JPG, BMP, GIF, TIFF
La conversion de Markdown en images peut être utile lorsque vous souhaitez créer une représentation visuelle de votre contenu, le partager sur les médias sociaux, l’intégrer dans des sites Web ou des articles de blog, ou l’utiliser dans le cadre d’une présentation. La bibliothèque Aspose.HTML for Java propose un large éventail de conversions Markdown en images, telles que JPG, PNG, BMP, TIFF et GIF. La conversion de Markdown en n’importe quel format d’image pris en charge suit les étapes obligatoires :
- Ouvrir un fichier Markdown.
- Convertir un fichier Markdown en document HTML.
- Créer un objet ImageSaveOptions.
- Convertir le document HTML au format d’image choisi à l’aide de la classe Converter.
La seule différence réside dans la spécification du format de l’image de sortie à l’aide de la classe
ImageSaveOptions. Le constructeur ImageSaveOptions(format)
initialise l’objet options avec le format spécifié. Vous pouvez définir le format de l’image comme JPG, PNG, BMP, GIF ou TIFF. Le format d’image par défaut est PNG.
Dans cet article, vous trouverez des informations sur la façon de convertir un Markdown en image en utilisant Aspose.HTML for Java et comment appliquer
ImageSaveOptions Vous pouvez facilement utiliser des exemples Java pour convertir Markdown en images, qui sont détaillés ici, pour convertir Markdown en PNG, JPG, BMP, GIF, et TIFF. Il suffit de définir le ImageFormat
à ImageSaveOptions !
Markdown vers PNG
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. Vous pouvez convertir un fichier Markdown en image dans votre application Java en quelques lignes de code !
- Utilisez la méthode
convertMarkdown(
sourcePath
) pour convertir un document Markdown en document HTML. - Créer un nouvel objet
ImageSaveOptions.
ImageFormat.Png
sera utilisé comme format d’image par défaut. - Utilisez la méthode
сonvertHTML(document, options, savePath)
de la classe Converter pour enregistrer un document HTML intermédiaire en tant qu’image PNG. La méthode prend en paramètredocument
,options
, etsavePath
et effectue la conversion.
Si votre scénario nécessite le rendu d’un document Markdown, par exemple, au format PNG, l’exemple suivant montre comment cela est simple :
1// Convert Markdown to PNG using Java
2
3// Prepare a simple Markdown example
4String code = "### Hello, World\n\n" +
5 "[visit applications](https://products.aspose.app/html/family)";
6
7// Create a Markdown file
8try (java.io.FileWriter fileWriter = new java.io.FileWriter("document.md")) {
9 fileWriter.write(code);
10}
11
12// Convert Markdown to HTML document
13HTMLDocument document = Converter.convertMarkdown("document.md");
14
15// Convert HTML document to PNG image file format
16Converter.convertHTML(document, new ImageSaveOptions(ImageFormat.Png), "output_md.png");
Options d’enregistrement – Classe ImageSaveOptions
Aspose.HTML for Java offre la possibilité de convertir par programme des documents Markdown en images avec un contrôle total sur les différentes options de conversion en utilisant ImageSaveOptions. Cette fonctionnalité permet aux utilisateurs de personnaliser le processus de rendu en définissant le format d’image, la taille de la page, les marges, le niveau de compression, le type de média, et d’autres paramètres.
Method | Description |
---|---|
setCompression(value) | Sets the Tagged Image File Format (TIFF) Compression. By default this property is Compression.LZW . |
getCss | Gets a CssOptions object which is used for configuration of CSS properties processing. |
setFormat(value) | Sets ImageFormat (JPG, PNG, BMP, TIFF, or GIF). By default this property is ImageFormat.Png . |
setBackgroundColor(value) | Sets Color which will fill background of every page. Default value is Color.Transparent(Color.getTransparent()) . |
setPageSetup(value) | Gets a page setup object is used for configuration output page-set. |
setHorizontalResolution(value) | Sets horizontal resolution for output images in pixels per inch. The default value is 300 dpi. |
setVerticalResolution(value) | Sets vertical resolution for output images in pixels per inch. The default value is 300 dpi. |
setSmoothingMode(value) | Sets the rendering quality for this image. |
getText() | Gets a TextOptions object which is used for configuration of text rendering. |
Pour plus d’informations sur la personnalisation du processus de conversion avec ImageSaveOptions, vous pouvez vous référer à l’article Convertisseurs à réglage fin.
Convertir Markdown en JPG avec ImageSaveOptions
Aspose.HTML for Java permet de convertir Markdown en image en utilisant des options d’enregistrement par défaut ou personnalisées. La définition de différentes options de la classe ImageSaveOptions permet de contrôler la taille de la page, les marges, la couleur d’arrière-plan et les paramètres de résolution de l’image de sortie.
L’exemple Java suivant montre comment utiliser ImageSaveOptions
et créer un fichier JPG avec une taille de page, des marges, une résolution et une qualité de rendu personnalisées :
- Utilisez la méthode
convertMarkdown(
sourcePath
) pour convertir un document Markdown en document HTML. - Créez un nouvel objet
ImageSaveOptions avec JPG
ImageFormat
et spécifiez les options d’enregistrement requises :- Utilisez la méthode
setSmoothingMode()
pour définir la qualité du lissage de l’image sur élevée. - Utilisez les méthodes
setHorizontalResolution()
etsetVerticalResolution()
pour définir la résolution horizontale et verticale de l’image sur 200. - Utilisez la méthode
setAnyPage()
pour définir la taille de l’image et les marges.
- Utilisez la méthode
- Utilisez la méthode
convertHTML(document, options, savePath)
pour enregistrer un fichier Markdown en tant qu’image JPG. La méthode prend ledocument
, lesoptions
, le chemin du fichier de sortiesavePath
et effectue l’opération de conversion.
1// Convert Markdown to JPG in Java with custom settings
2
3// Convert Markdown to HTML
4HTMLDocument document = Converter.convertMarkdown("nature.md");
5
6// Initialize ImageSaveOptions
7ImageSaveOptions options = new ImageSaveOptions(ImageFormat.Jpeg);
8options.setSmoothingMode(SmoothingMode.HighQuality);
9options.setHorizontalResolution(Resolution.to_Resolution(200));
10options.setVerticalResolution(Resolution.to_Resolution(200));
11options.setBackgroundColor(Color.getAliceBlue());
12options.getPageSetup().setAnyPage(new Page(new Size(600, 950), new Margin(30, 20, 10, 10)));
13
14// Convert HTML to JPG
15Converter.convertHTML(document, options, "nature-options.jpg");
Conclusion
La conversion de Markdown en formats d’image tels que PNG, JPG, BMP, GIF ou TIFF est une approche pratique pour représenter visuellement le contenu dans des présentations, des messages sur les médias sociaux ou des pages Web. Aspose.HTML for Java fournit une API robuste pour atteindre cet objectif de manière simple et flexible. En utilisant la classe ImageSaveOptions
, les développeurs peuvent personnaliser les propriétés de l’image telles que le format, ce qui permet une sélection transparente entre les formats d’image pris en charge. En outre, l’API permet d’affiner les propriétés de sortie telles que la résolution, les marges, la couleur d’arrière-plan, la qualité de rendu, etc. pour répondre aux besoins spécifiques de l’utilisateur.
La conversion de Markdown en formats d’image implique une étape intermédiaire importante : la conversion de Markdown en HTML. Aspose.HTML for Java implémente ce processus avec sa classe Converter
, garantissant une génération HTML précise comme base pour la conversion ultérieure en image.
Vous pouvez télécharger les exemples complets et les fichiers de données à partir de GitHub.
Aspose.HTML propose un Convertisseur Markdown vers Image gratuit en ligne qui convertit Markdown en JPG avec une haute qualité, facilement et rapidement. Si vous avez besoin d’inclure des fichiers Markdown dans une présentation PowerPoint ou de les envoyer par courrier électronique, transformez-les au format d’image approprié et utilisez-les comme vous le souhaitez ! Il suffit de télécharger, de convertir vos fichiers et d’obtenir le résultat en quelques secondes !