Convertir Markdown en PDF – C#

Markdown est un langage de balisage avec une syntaxe de formatage de texte brut. Markdown est souvent utilisé comme format pour la documentation et les fichiers readme, car il permet d’écrire dans un style facile à lire et à écrire. Sa conception lui permet d’être facilement converti dans de nombreux formats de sortie, mais à l’origine, il a été créé pour convertir uniquement en HTML. En utilisant la bibliothèque Aspose.HTML for .NET dans votre application C#, vous pouvez facilement convertir Markdown en un fichier PDF avec seulement quelques lignes de code !

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

Convertisseur Markdown en ligne

Vous pouvez convertir Markdown en d’autres formats avec l’API Aspose.HTML for .NET en temps réel. Veuillez charger un fichier Markdown à partir du système de fichiers local, sélectionnez le format de sortie et exécutez l’exemple. Les options d’enregistrement sont définies par défaut. Vous recevrez immédiatement 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 C# suivants.

Note: Les conversions de Markdown vers des formats tels que PDF, XPS, DOCX et des formats d’image passent par l’étape de conversion de Markdown vers HTML.

Convertir Markdown en PDF en C#

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. Préparer un document source Markdown. Dans l’exemple, nous créons un fichier Markdown à partir du code.
2. Préparer un chemin d’accès pour l’enregistrement du fichier converti.
3. Convertir Markdown en HTML. Utilisez la méthode ConvertMarkdown(sourcePath) pour enregistrer Markdown en tant que document HTML.
4. Utilisez la méthode ConvertHTML() pour convertir le document HTML intermédiaire au format PDF. Vous devez transmettre le document HTML, les options PdfSaveOptions et le chemin du fichier de sortie à la méthode ConvertHTML() pour la conversion HTML au format PDF.

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 C#

// Prepare a path to a source Markdown file
string sourcePath = Path.Combine(OutputDir, "document.md");

// Prepare a simple Markdown example
string code = "### Hello, World!" +
              "\r\n" +
              "[visit applications](https://products.aspose.app/html/applications)";
// Create a Markdown file
File.WriteAllText(sourcePath, code);

// Convert Markdown to HTML 
using HTMLDocument document = Converter.ConvertMarkdown(sourcePath);

// Prepare a path for converted PDF file saving 
string savePath = Path.Combine(OutputDir, "document-output.pdf");

// Convert the HTML document to PDF file format
Converter.ConvertHTML(document, new PdfSaveOptions(), savePath);

Convertir Markdown en PDF en utilisant PdfSaveOptions

Si vous souhaitez convertir un document Markdown existant à partir d’un système de fichiers local, l’exemple suivant peut vous aider. Vous devez suivre quelques étapes :

1. Ouvrir un document Markdown existant. Dans l’exemple, nous chargeons un fichier Markdown à partir d’un système de fichiers local ( nature.md).
2. Préparer un chemin d’accès pour l’enregistrement du fichier PDF converti.
3. Convertir Markdown en HTML. Utilisez la méthode ConvertMarkdown(sourcePath) de la classe Converter pour enregistrer Markdown en tant que document HTML.
4. Créez un nouvel objet PdfSaveOptions et spécifiez les propriétés requises.
5. Utilisez la méthode ConvertHTML() pour convertir le document HTML intermédiaire au format PDF. Vous devez transmettre le document HTML, les options PdfSaveOptions et le chemin du fichier de sortie à la méthode ConvertHTML().

L’extrait de code suivant montre comment convertir Markdown en PDF à l’aide d’Aspose.HTML for .NET.

// Convert Markdown to PDF in C# with custom settings

// Prepare a path to a source Markdown file
string sourcePath = Path.Combine(DataDir, "nature.md");

// Prepare a path to save the converted file
string savePath = Path.Combine(OutputDir, "nature-output.pdf");

// Convert Markdown to HTML
using HTMLDocument document = Converter.ConvertMarkdown(sourcePath);

// Initialize PdfSaveOptions. Set up the resolutions, JpegQuality and change the background color to AliceBlue 
PdfSaveOptions options = new PdfSaveOptions()
{
    HorizontalResolution = 200,
    VerticalResolution = 200,
    BackgroundColor = System.Drawing.Color.AliceBlue,
    JpegQuality = 100
};

// Convert the HTML document to PDF file format
Converter.ConvertHTML(document, options, savePath);

La classe PdfSaveOptions fournit de nombreuses propriétés qui vous permettent de contrôler un large éventail de paramètres et d’améliorer le processus de conversion du format Markdown au format PDF. Pour en savoir plus sur PdfSaveOptions, veuillez lire l’article Convertisseurs à réglage fin.

Dans l’exemple ci-dessus, nous utilisons :

• propriété JpegQuality qui vous permet de spécifier la qualité de la compression JPEG pour les images. La valeur par défaut est 95.
• propriété BackgroundColor qui définit la couleur de l’arrière-plan. La couleur d’arrière-plan par défaut est Transparent.
• les propriétés HorizontalResolution et VerticalResolution définissent la résolution horizontale/verticale des images de sortie en pixels par pouce. Par défaut, ces propriétés sont de 300 dpi.

Téléchargez la bibliothèque Aspose.HTML for .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 !