Convert Markdown to Image in C#

To convert Markdown to image formats in C#, first use Converter.ConvertMarkdown() to create an intermediate HTMLDocument, then render it with Converter.ConvertHTML() and ImageSaveOptions. Set the image format to JPG, PNG, BMP, GIF, or TIFF.

Markdown to image conversion is useful for previews, thumbnails, documentation snapshots, visual archives, and systems that need raster output instead of editable Markdown or HTML. In Aspose.HTML for .NET, Markdown is parsed to HTML first, then the intermediate HTMLDocument is rendered to the selected image format.

Before running the examples, install and configure Aspose.HTML for .NET in your project. The complete C# example project is available in the Aspose.HTML for .NET GitHub repository.

Convert Markdown to JPG in C#

Use JPG output when you need compact previews or thumbnails and small file size matters more than transparency or lossless text edges. The example creates a Markdown source, converts it to an intermediate HTMLDocument, and renders it to JPG.

The workflow is:

1. Prepare the Markdown source file.
2. Convert Markdown to an HTMLDocument with Converter.ConvertMarkdown(sourcePath).
3. Create an ImageSaveOptions instance with the required image format, such as ImageFormat.Jpeg.
4. Call Converter.ConvertHTML(document, options, savePath) to render the intermediate HTML document as an image file.

// Convert Markdown to JPG 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/family)";
// Create a Markdown file
File.WriteAllText(sourcePath, code);

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

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

// Convert HTML document to JPG image file format
Converter.ConvertHTML(document, new ImageSaveOptions(ImageFormat.Jpeg), savePath);

Convert Markdown to JPG with ImageSaveOptions

Use ImageSaveOptions when the generated image needs custom rendering settings. The example below converts an existing Markdown file and applies image save options before rendering to JPG.

To customize Markdown to image conversion:

1. Load or create the Markdown source file.
2. Convert Markdown to an intermediate HTMLDocument with Converter.ConvertMarkdown().
3. Create ImageSaveOptions and choose the output format.
4. Configure only the options required by the target output, such as PageSetup, BackgroundColor, HorizontalResolution, VerticalResolution, UseAntialiasing, or TIFF Compression.
5. Pass the HTMLDocument, ImageSaveOptions, and output path to Converter.ConvertHTML().

// Convert Markdown to JPG 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-options.jpg");

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

// Initialize ImageSaveOptions 
ImageSaveOptions options = new ImageSaveOptions(ImageFormat.Jpeg)
{
    UseAntialiasing = true,
    HorizontalResolution = 200,
    VerticalResolution = 200,
    BackgroundColor = System.Drawing.Color.AliceBlue
};
options.PageSetup.AnyPage = new Page(new Aspose.Html.Drawing.Size(600, 950), new Margin(30, 20, 10, 10));

// Convert HTML to JPG
Converter.ConvertHTML(document, options, savePath);

Option	Use it to control
Format	The output image format. The default value is PNG; use ImageFormat.Jpeg, ImageFormat.Bmp, ImageFormat.Gif, or ImageFormat.Tiff when another format is required.
BackgroundColor	The color used to fill the image background. The default value is transparent.
PageSetup	Page size, margins, and page layout settings.
HorizontalResolution and VerticalResolution	Output resolution values used by the rendering process. The default value is 300 dpi for each property.
UseAntialiasing	Image rendering quality. Antialiasing is enabled by default.
Text	Text rendering configuration through TextOptions.
Compression	TIFF compression. Use it only for TIFF output; the default value is LZW.

Use UseAntialiasing = true when you want to improve the visual quality of rendered shapes, text, and images, especially when clarity and smooth edges are important. Antialiasing can also increase processing time, so applications focused on rendering speed may choose UseAntialiasing = false.

Choose an Image Format for Markdown Output

• Use JPG for compact previews and thumbnails when file size matters.
• Use PNG for lossless output, sharp text, diagrams, UI screenshots, and transparency-friendly workflows.
• Use BMP when a Windows-oriented or legacy imaging pipeline expects bitmap files.
• Use GIF for simple compatibility-focused image output, not for high-detail full-color pages.
• Use TIFF for archiving, printing, scanning, document imaging, or workflows that need TIFF compression.

Convert Markdown to PNG in C#

PNG is the default ImageSaveOptions.Format value and is often the best choice for sharp documentation previews. The following example converts Markdown to PNG.

// Convert Markdown to PNG using C#

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

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

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

// Convert HTML document to PNG image file format
Converter.ConvertHTML(document, new ImageSaveOptions(), savePath);

Convert Markdown to BMP in C#

BMP can be useful for Windows-oriented or legacy image workflows. The following example converts Markdown to BMP.

// Convert Markdown to BMP using C#

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

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

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

// Convert HTML document to BMP image file format
Converter.ConvertHTML(document, new ImageSaveOptions(ImageFormat.Bmp), savePath);

Convert Markdown to GIF in C#

GIF can be useful for simple compatibility-focused output. The following example converts Markdown to GIF.

// Convert Markdown to GIF using C#

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

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

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

// Convert HTML document to GIF image file format
Converter.ConvertHTML(document, new ImageSaveOptions(ImageFormat.Gif), savePath);

Convert Markdown to TIFF in C#

TIFF can be useful for archival, printing, scanning, and document imaging workflows. The following example converts Markdown to TIFF.

// Convert Markdown to TIFF using C#

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

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

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

// Convert HTML document to TIFF image file format
Converter.ConvertHTML(document, new ImageSaveOptions(ImageFormat.Tiff), savePath);

Related Markdown Conversion Guides

• Convert Markdown to HTML – create HTML output directly from Markdown.
• Convert Markdown to PDF – render Markdown as a PDF document.
• Convert Markdown to DOCX – save Markdown content as a Word document.
• Convert Markdown to XPS – render Markdown as fixed-layout XPS output.

Other Platforms

• Convert Markdown to Image in Java
• Convert Markdown to Image in Python via .NET

Try Online Markdown to Image Conversion

Use the online MD to JPG Converter for quick manual conversion. Use Aspose.HTML for .NET when Markdown to image conversion must run inside a C# application, service, or documentation pipeline.