Markdown Converter | C#

Contents
[ ]

Markdown is a lightweight markup language designed to indicate formatting in plain text. MD files use Markdown language that was proposed and developed by John Gruber. They include inline text characters that determine how text is formatted, such as indentation, table formatting, fonts, and headings. In addition, MD files can be converted to HTML, PDF or images to take advantage of other formats for specific tasks.

The main highlight of Aspose.HTML is a conversion feature. The Aspose.Html.Converters namespace implements easy access to conversion methods. It provides a wide range of conversions to popular formats, such as Markdown to HTML, Markdown to DOCX, or Markdown to PDF.

This section provides information on the list of supported Markdown conversions and how to perform them using ConvertMarkdown() methods. All of these methods allow for the basic Markdown to HTML conversion. Conversions from Markdown to other formats go through the Markdown to HTML conversion stage.

Please take a look at the following C# example, which shows Markdown to JPG conversion with ImageSaveOptions specifying:

using System.IO;
using Aspose.Html.Converters;
using Aspose.Html.Rendering.Image;
using Aspose.Html.Saving;
using System.Drawing;
...  

    // Prepare a path to a source Markdown file
    string sourcePath = Path.Combine(DataDir, "nature.md");            
    
    // Prepare a path for converted file saving 
    string outputPath = Path.Combine(OutputDir, "nature-options.jpg");
    
    // Convert Markdown to HTML
    using var document = Converter.ConvertMarkdown(sourcePath);
    
    // Initialize an instance of ImageSaveOptions 
    var options = new ImageSaveOptions(ImageFormat.Jpeg)
    {
        BackgroundColor = Color.AliceBlue
    };
    
    // Convert HTML document to JPG image file format
    Converter.ConvertHTML(document, options, outputPath);

In the example, the ConvertMarkdown(sourcePath) method takes the source path of an Markdown file and results an HTMLDocument. The ImageSaveOptions() constructor creates a new ImageSaveOptions object with JPG ImageFormat and BackgroundColor properties. Then, the ConvertHTML() method takes HTMLDocument, ImageSaveOptions, and output path and completes the Markdown to JPG conversion.