Convert Markdown to XPS | C#

MD 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 an XPS file with just a few lines of code!

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.

Code example in C# to convert document formats
Input file
Upload a file you want to convert
Output format
Select the target format

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

Convert Markdown to XPS in C#

Conversions from Markdown to other formats go through the Markdown to HTML conversion stage. If your scenario is required rendering Markdown document, for instance, to the XPS file format, the following example demonstrates how that is simple:

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

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

using System.IO;
using Aspose.Html.Converters;
using Aspose.Html.Saving;
...
    // Prepare a path to a source Markdown file
     string sourcePath = Path.Combine(OutputDir, "document.md");

     // Prepare a simple Markdown example
     var code = "### Hello, World!" +
                "\r\n" +
                "[visit applications](https://products.aspose.app/html/family)";
     // Create a Markdown file
     File.WriteAllText(sourcePath, code);
    
     // Prepare a path for converted file saving 
     string savePath = Path.Combine(OutputDir, "document-output.xps");
    
     // Convert Markdown to HTML 
     using var document = Converter.ConvertMarkdown(sourcePath);
    
     // Convert HTML to XPS file format
     Converter.ConvertHTML(document, new XpsSaveOptions(), savePath);

Convert Markdown to XPS using XpsSaveOptions

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:

  1. Open an existing Markdown document. In the example, we load a Markdown file from a local file system (nature.md).
  2. Prepare a path for converted XPS file saving.
  3. Convert Markdown to HTML. Use the ConvertMarkdown(sourcePath) method of the Converter class to save Markdown as an HTML document.
  4. Create a new XpsSaveOptions object and specify the required properties.
  5. Use the ConvertHTML() method for HTML to XPS conversion. You need to pass the HTMLDocument, XpsSaveOptions, and output file path to the ConvertHTML() method.

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

using System.IO;
using Aspose.Html.Converters;
using Aspose.Html.Saving;
using Aspose.Html.Drawing;
using System.Drawing;
...
    // Prepare a path to a source Markdown file
    string sourcePath = Path.Combine(DataDir, "nature.md");

    // Prepare a path for converted PDF file saving 
    string savePath = Path.Combine(OutputDir, "nature-output.xps");
    
    // Convert Markdown to HTML
    using var document = Converter.ConvertMarkdown(sourcePath);
    
    // Initialize XpsSaveOptions. Set up the resilutions, page-size, margins and change the background color to AntiqueWhite 
    var options = new XpsSaveOptions()
    {
        HorizontalResolution = 200,
        VerticalResolution = 200,
        BackgroundColor = Color.AntiqueWhite
    };
    options.PageSetup.AnyPage = new Page(new Aspose.Html.Drawing.Size(Length.FromInches(5.0f), Length.FromInches(10.0f)), new Margin(30, 20, 10, 10));
    
    // Convert the HTML document to XPS file format
    Converter.ConvertHTML(document, options, savePath);

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

In the example, we use:

  • 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;
  • PageSetup property that specifies the page size and margins.

Text “Banner MD to XPS Converter”