Convertir Markdown en PDF en Python

Cet article fournit des informations sur la conversion de Markdown en PDF à l’aide de l’API Aspose.HTML for Python via .NET. Vous découvrirez les scénarios de conversion Markdown-PDF pris en charge et des exemples Python pour les illustrer. Vous pouvez également essayer un convertisseur Markdown en ligne pour tester les fonctionnalités d’Aspose.HTML et convertir Markdown à la volée.

Convertisseur Markdown en ligne

Vous pouvez convertir Markdown en d’autres formats avec Aspose.HTML en temps réel. Chargez un fichier Markdown, sélectionnez le format de sortie et exécutez l’exemple. Les options d’enregistrement sont configurées par défaut. Vous recevrez instantanément le résultat de la conversion dans un fichier séparé.

Si vous souhaitez convertir Markdown en PDF de manière programmatique, veuillez consulter les exemples de code Python suivants.

Convertir Markdown en PDF

Si votre scénario nécessite le rendu d’un document Markdown, par exemple, au format PDF, l’exemple suivant montre comment cela est simple :

1. Charger un document source Markdown. Dans l’exemple, nous créons un fichier Markdown à partir du code.
2. Convertir Markdown en HTML. Utilisez la méthode convert_markdown() pour enregistrer Markdown en tant que document HTML.
3. Créez un nouvel objet PdfSaveOptions et spécifiez les propriétés requises.
4. Utilisez la méthode convert_html() de la classe Converter. Vous devez passer les paramètres HTMLDocument, PdfSaveOptions, et le chemin du fichier de sortie save_path à la méthode convert_html().

Si vous souhaitez créer un document Markdown à partir d’une chaîne utilisateur directement dans votre code et le convertir en fichier PDF, l’exemple suivant peut vous aider :

# Convert Markdown to PDF using Python

import os
import aspose.html.converters as conv
import aspose.html.saving as sav

# Setup output directory and paths
output_dir = "output/"
os.makedirs(output_dir, exist_ok=True)
source_path = os.path.join(output_dir, "document.md")
save_path = os.path.join(output_dir, "markdown-to-pdf.pdf")

# Create a simple Markdown example file
code = "### Hello, World!\nConvert Markdown to PDF!"
with open(source_path, "w") as file:
    file.write(code)

# Convert Markdown file to an intermediate HTMLDocument
document = conv.Converter.convert_markdown(source_path)

# Create an instance of PdfSaveOptions
options = sav.PdfSaveOptions()

# Convert HTML to PDF
conv.Converter.convert_html(document, options, save_path)

Convertir Markdown en PDF en utilisant PdfSaveOptions

Le processus de conversion de Markdown en PDF peut être personnalisé de manière flexible. Aspose.HTML for Python via .NET fournit la classe PdfSaveOptions, qui vous donne plus de contrôle sur la façon dont les documents sont enregistrés au format PDF. Voici une description des propriétés disponibles dans PdfSaveOptions :

• page_setup – Cette propriété donne accès à un objet PageSetup utilisé pour configurer la mise en page et les paramètres des pages PDF de sortie afin de répondre à des exigences spécifiques en matière d’impression ou d’affichage.
• horizontal_resolution – Cette propriété contrôle la résolution horizontale des images internes utilisées pendant le traitement et des images externes incluses dans le code HTML. Par défaut, elle est fixée à 300 dpi.
• vertical_resolution – Similaire à horizontal_resolution, cette propriété gère la résolution verticale des images internes et externes lors de la génération du PDF. Comme pour la résolution horizontale, la valeur par défaut est de 300 dpi.
• background_color – Cette propriété définit ou récupère la couleur d’arrière-plan qui remplit chaque page du document PDF. La valeur par défaut est transparente, mais elle peut être personnalisée en fonction des préférences de marque ou d’esthétique, afin d’assurer la cohérence entre toutes les pages.
• css – Cette propriété utilise un objet CssOptions pour configurer le traitement des propriétés CSS pendant la conversion HTML vers PDF. Elle permet un contrôle précis de la manière dont les styles du HTML sont interprétés et appliqués dans le PDF résultant.
• document_info – Cette propriété contient des métadonnées et des informations sur le document PDF de sortie, telles que le titre, l’auteur, le sujet et les mots-clés. Ces métadonnées facilitent la gestion, l’indexation et la recherche de documents, en rendant le PDF plus informatif et mieux organisé.
• form_field_behaviour – Cette propriété spécifie le comportement des champs de formulaire interactifs dans le PDF généré.
• jpeg_quality – Cette propriété détermine la qualité de compression JPEG utilisée pour les images intégrées dans un document PDF. La qualité par défaut est fixée à 95, ce qui offre un bon équilibre entre la fidélité de l’image et la taille du fichier. Le réglage de cette propriété vous permet d’optimiser la taille du fichier ou la qualité de l’image en fonction de vos besoins spécifiques.
• encryption – Cette propriété fournit des informations détaillées sur le cryptage des documents PDF, y compris la protection par mot de passe et les paramètres d’autorisation. Si elle n’est pas configurée, aucun cryptage n’est appliqué, mais la définition de cette propriété vous permet de distribuer et de contrôler l’accès au contenu PDF sensible en toute sécurité.
• is_tagged_pdf – Lorsque la valeur est vraie, une mise en page balisée est créée dans le document PDF, ce qui améliore l’accessibilité pour les utilisateurs handicapés. Cela permet de s’assurer que le contenu est correctement structuré et navigable à l’aide d’une technologie d’assistance et qu’il respecte les normes d’accessibilité.

Vous devez utiliser la classe PdfSaveOptions pour spécifier des options supplémentaires qui affectent le résultat de l’enregistrement d’un document au format PDF. Cette classe contient des propriétés qui déterminent la manière dont le document PDF sera affiché. L’extrait de code Python suivant montre comment convertir un document Markdown en PDF à l’aide de PdfSaveOptions :

# Convert Markdown to PDF using Python with custom settings

import os
import aspose.html.converters as conv
import aspose.html.saving as sav
import aspose.html.drawing as dr

# Setup directories and define paths
output_dir = "output/"
input_dir = "data/"
if not os.path.exists(output_dir):
    os.makedirs(output_dir)
document_path = os.path.join(input_dir, "document.md")
save_path = os.path.join(output_dir, "md-to-pdf-with-save-options.pdf")

# Convert Markdown to HTML
document = conv.Converter.convert_markdown(document_path)

# Create an instance of PdfSaveOptions
options = sav.PdfSaveOptions()
options.page_setup.any_page = dr.Page(dr.Size(300, 300), dr.Margin(30, 10, 10, 10))
options.css.media_type.PRINT
options.jpeg_quality = 100

# Convert HTML to PDF
conv.Converter.convert_html(document, options, save_path)

Dans ce code, la classe PdfSaveOptions de Aspose.HTML for Python via .NET est utilisée pour personnaliser la conversion de Markdown en PDF.

• La propriété page_setup configure les paramètres de mise en page pour le PDF de sortie, en fixant la taille de la page à 300x300 unités avec des marges de 10 unités de tous les côtés.
• Le paramètre jpeg_quality est fixé à 100, ce qui maximise la qualité des images JPEG incluses dans le PDF.
• Le css.media_type est fixé à PRINT, ce qui spécifie que le type de média CSS pour l’impression doit être utilisé lors de la conversion, garantissant ainsi un style approprié.

Ces paramètres garantissent que le PDF résultant est bien formaté, qu’il est stylisé de manière appropriée pour l’impression et qu’il contient des images de haute qualité.

Comment convertir Markdown en XPS

Aspose.HTML for Python via .NET prend en charge la conversion Markdown vers XPS. Pour ce faire, vous devez utiliser XpsSaveOptions pour obtenir un objet d’options de sauvegarde qui est passé à la méthode convert_html() :

options = sav.XpsSaveOptions()

L’utilisation de XpsSaveOptions vous permet de personnaliser le processus de rendu ; vous pouvez spécifier les propriétés page_setup, background_color, css, horizontal_resolution et vertical_resolution.

Téléchargez la bibliothèque Aspose.HTML for Python via .NET qui vous permet de convertir avec succès, rapidement et facilement vos documents HTML, MHTML, EPUB, SVG et Markdown vers les formats les plus populaires.

Vous pouvez vérifier la qualité de la conversion Markdown vers PDF avec notre Convertisseur Markdown vers PDF en ligne. Téléchargez, convertissez vos fichiers et obtenez des résultats en quelques secondes. Essayez gratuitement notre convertisseur Markdown vers PDF !