Convert HTML to MHTML in C#

To convert HTML to MHTML in C#, use Converter.ConvertHTML() with an HTML source, MHTMLSaveOptions, and an output path. Aspose.HTML for .NET can package HTML and related resources into a single MHTML web archive, and MHTMLSaveOptions lets you control page URL restrictions, resource URL restrictions, and handling depth.

This guide shows the core HTML to MHTML workflows for C# applications: a one-line conversion, a file-based conversion, and custom MHTML save options. 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.

MHTML combines HTML markup and external resources, such as images, CSS, scripts, and other linked assets, into one archive file. Use HTML to MHTML conversion when your application needs a portable single-file snapshot of a web page or generated HTML content.

Convert HTML to MHTML with One Line of C#

For simple input, the static Converter class provides a short path from HTML content to an MHTML file. The example below passes HTML code, a base URI, default MHTMLSaveOptions, and the output file path to ConvertHTML().

// Convert HTML to MHTML using C#

// Invoke the ConvertHTML() method to convert HTML to MHTML
Converter.ConvertHTML(@"<h1>Hellow, Word!</h1>", ".", new MHTMLSaveOptions(), Path.Combine(OutputDir, "convert-with-single-line.mht"));

Use this pattern when your HTML is already available as a string and default MHTML packaging settings are enough. For file input or custom resource handling, use the workflows below.

Convert an HTML File to MHTML in C#

A typical file-based conversion uses an HTMLDocument instance, an MHTMLSaveOptions object, and Converter.ConvertHTML(). You can load HTML from a local file, HTML code, stream, or URL. For more loading patterns, see Creating an HTML Document.

The workflow is:

1. Load the HTML file with an HTMLDocument constructor.
2. Create an MHTMLSaveOptions instance.
3. Call Converter.ConvertHTML(document, options, savePath) to write the MHTML archive.

The following C# code converts an HTML document to MHTML.

// Convert HTML to MHTML in C#

// Prepare a path to a source HTML file
string documentPath = Path.Combine(DataDir, "drawing.html");

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

// Initialize an HTML document from the file
using HTMLDocument document = new HTMLDocument(documentPath);

// Initialize MHTMLSaveOptions 
MHTMLSaveOptions options = new MHTMLSaveOptions();

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

Short HTML to MHTML Recipes

• Convert an HTML string to MHTML – pass the HTML content, base URI, MHTMLSaveOptions, and output path to Converter.ConvertHTML().
• Convert an HTML file to MHTML – load the file with HTMLDocument, create MHTMLSaveOptions, and call Converter.ConvertHTML(document, options, savePath).
• Convert HTML from a URL to MHTML – create an HTMLDocument from the URL, then convert the loaded document to a single-file archive.
• Limit handled pages – configure MHTMLSaveOptions.PageUrlRestriction and MaxHandlingDepth.
• Limit handled resources – configure MHTMLSaveOptions.ResourceUrlRestriction for CSS, images, scripts, and other linked files.
• Save a website or page for archiving – see Website to HTML when you need broader website-saving workflows.

Customize HTML to MHTML with MHTMLSaveOptions

Use MHTMLSaveOptions when the output archive needs custom resource handling. The options object is passed to ConvertHTML() and controls which pages and resources are included in the generated MHTML file.

Option	Use it to control
PageUrlRestriction	Restrictions applied to URLs of handled pages. The default value is RootAndSubFolders.
ResourceUrlRestriction	Restrictions applied to handled resources such as CSS, JavaScript, images, and other linked files. The default value is SameHost.
MaxHandlingDepth	Maximum depth of pages that will be handled during packaging. The default value is 0.

The following example creates an MHTML file with custom save options.

// Convert HTML to MHTML with custom settings using C#

// Prepare HTML code with a link to another file and save it to the file as 'document.html'
string code = "<span>Hello, World!!</span> " +
              "<a href='document2.html'>click</a>";
File.WriteAllText("document.html", code);

// Prepare HTML code and save it to the file as 'document2.html'
code = @"<span>Hello, World!!</span>";
File.WriteAllText("document2.html", code);

string savePath = Path.Combine(OutputDir, "output-options.mht");

// Change the value of the resource linking depth to 1 in order to convert document with directly linked resources
MHTMLSaveOptions options = new MHTMLSaveOptions()
{
    ResourceHandlingOptions =
    {
        MaxHandlingDepth = 1
    }
};

// Convert HTML to MHTML
Converter.ConvertHTML("document.html", options, savePath);

In this example, MHTMLSaveOptions is passed to Converter.ConvertHTML() together with the loaded HTML document and output path. The sample uses MaxHandlingDepth = 1, which means only pages directly referenced from the saved document will be handled.

For deeper resource and rendering settings, see Fine-Tuning Converters.

Related MHTML Workflows

• Website to HTML – save a web page or website with related resources.
• Save File from URL – download files from URLs in C#.
• Convert MHTML to PDF – convert MHTML archives back to PDF.
• MHTML Converter – convert MHTML archives to document and image formats.

Related HTML Conversion Guides

• Convert HTML to PDF – create PDF output with PdfSaveOptions.
• Convert HTML to DOCX – save HTML as a Word document with DocSaveOptions.
• Convert HTML to XPS – render HTML to XPS output.
• Convert HTML to PNG – render HTML to PNG images.
• Convert HTML to JPG – render HTML to JPEG images.
• Convert HTML to Markdown – transform HTML content into Markdown.

Other Platforms

• Convert HTML to MHTML in Java
• Convert HTML to MHTML in Python via .NET

Try Online HTML to MHTML Conversion

Use the online HTML to MHTML Converter for quick manual conversion. Use Aspose.HTML for .NET when HTML to MHTML packaging must run inside a C# application, service, or archive workflow.