Convert Markdown to PDF – C# Examples and Online Converter

Markdown is a markup language with a plain-text-formatting syntax. Markdown is often used as a format for documentation and readme files since it allows writing in an easy-to-read and easy-to-write style. Its design allows it to be easily converted to many output formats, but initially, it was created to convert only to HTML. Using the Aspose.HTML class library in your C# application, you can easily convert Markdown into a PDF file with just a few lines of code!

This article provides information on how to convert Markdown to PDF using the Aspose.HTML API. You will learn about the supported Markdown to PDF conversion scenarios and consider C# examples to illustrate them. Also, you can try an Online Markdown Converter to test the Aspose.HTML API functionality and convert Markdown on the fly.

Online Markdown Converter

You can convert Markdown to other formats with Aspose.HTML for .NET API in real time. Please load a Markdown file from the local file system, select the output format and run the example. The save options are set by default. You will immediately receive the conversion result as a separate file.

If you want to convert Markdown to PDF programmatically, please see the following C# code examples.

Convert Markdown to PDF in C#

If your scenario is required rendering Markdown document, for instance, to the PDF file format, the following example demonstrates how that is simple:

Prepare a source Markdown document. In the example, we create a Markdown file from code.
Prepare a path for converted file saving.
Convert Markdown to HTML. Use the ConvertMarkdown(sourcePath) method to save Markdown as an HTML document.
Use the ConvertHTML() method to render the intermediary HTML document to PDF format. You need to pass the HTMLDocument, PdfSaveOptions, and output file path to the ConvertHTML() method for HTML to PDF conversion.

If your case is to create a Markdown document from a user string directly in your code and convert it to a PDF file, the following example could help you:

 1using System.IO;
 2using Aspose.Html.Converters;
 3using Aspose.Html.Saving;
 4...
 5    // Prepare a path to a source Markdown file
 6    string sourcePath = Path.Combine(OutputDir, "document.md");
 7
 8    // Prepare a simple Markdown example
 9    var code = "### Hello, World!" +
10               "\r\n" +
11               "[visit applications](https://products.aspose.app/html/applications)";
12    // Create a Markdown file
13    File.WriteAllText(sourcePath, code);
14
15    // Prepare a path for converted file saving 
16    string savePath = Path.Combine(OutputDir, "document-output.pdf");
17
18    // Convert Markdown to HTML document
19    using var document = Converter.ConvertMarkdown(sourcePath);
20
21    // Convert HTML document to PDF image file format
22    Converter.ConvertHTML(document, new PdfSaveOptions(), savePath);

You can download the complete examples and data files from GitHub.

Convert Markdown to PDF using PdfSaveOptions

If your case is to convert an existing Markdown document from a local file system, the following example could help you. You need to follow a few steps:

Open an existing Markdown document. In the example, we load a Markdown file from a local file system ( nature.md).
Prepare a path for converted PDF file saving.
Convert Markdown to HTML. Use the ConvertMarkdown(sourcePath) method of the Converter class to save Markdown as an HTML document.
Create a new PdfSaveOptions object and specify the required properties.
Use the ConvertHTML() method to render the intermediary HTML document to PDF format. You need to pass the HTMLDocument, PdfSaveOptions, and output file path to the ConvertHTML() method.

The following code snippet shows how to convert Markdown to PDF using Aspose.HTML for .NET.

 1using System.IO;
 2using Aspose.Html.Converters;
 3using Aspose.Html.Saving;
 4using System.Drawing;
 5...
 6    // Prepare a path to a source Markdown file
 7    string sourcePath = Path.Combine(DataDir, "nature.md");
 8
 9    // Prepare a path for converted PDF file saving 
10    string savePath = Path.Combine(OutputDir, "nature-output.pdf");
11
12    // Convert Markdown to HTML document
13    using var document = Converter.ConvertMarkdown(sourcePath);
14
15    // Initialize PdfSaveOptions. Set up the resolutions, JpegQuality and change the background color to AliceBlue 
16    var options = new PdfSaveOptions()
17    {
18        HorizontalResolution = 200,
19        VerticalResolution = 200,
20        BackgroundColor = System.Drawing.Color.AliceBlue,
21        JpegQuality = 100
22    };
23
24    // Convert HTML document to PDF image file format
25    Converter.ConvertHTML(document, options, savePath);

The PdfSaveOptions class provides numerous properties that give you full control over a wide range of parameters and improve the process of converting Markdown to PDF format. To learn more about PdfSaveOptions, please read the Fine-Tuning Converters article.

In the above example, we use:

JpegQuality property that enables you to specify the quality of JPEG compression for images. The default value is 95;
BackgroundColor property that sets the color that will fill the background. The default BackgroundColor is Transparent;
HorizontalResolution and VerticalResolution properties that set horizontal/vertical resolution for output images in pixels per inch. By default, these properties are 300 dpi.

Download our Aspose.HTMLfor .NET library allows you to successfully, quickly, and easily convert your HTML, MHTML, EPUB, SVG, and Markdown documents to the most popular formats.

You can check the quality of Markdown to PDF conversion with our online MD to PDF Converter. Upload, convert your files and get results in a few seconds. Try our forceful Markdown to PDF Converter for free now!

Convert Markdown to HTML Convert Markdown to DOCX