Convert to HTML with advanced options Leave feedback

GroupDocs.Conversion provides WebConvertOptions to give you control over conversion result. The following options could be set:

• FixedLayout controls the HTML generation. If it’s set to true, fixed layout will be used e.g. absolutely positioned HTML element.
• FixedLayoutShowBorders controls the display of page borders during fixed layout conversion. Default is true.
• EmbedFontResources specifies whether to embed font resources within the main HTML. Default is false. Note: fonts automatically embed when FixedLayout is enabled.
• Zoom specifies the zoom level in percentage. The default value is 100.
• UsePdf. Sometimes, for better rendering and elements positioning the source document should be converted to PDF first. If this property is set to true, the input firstly is converted to PDF and after that to desired format.
• SlideShow converts a presentation to a single HTML file that plays as a slideshow, with slide transitions and shape animations. Default is false. See Convert a presentation to an HTML slideshow.

The following code snippet shows how to convert to HTML with advanced options

using (Converter converter = new Converter("sample.docx"))
{
    WebConvertOptions options = new WebConvertOptions
    {
        PageNumber = 2,
        PagesCount = 1,
        FixedLayout = true
    };
    converter.Convert("converted.html", options);
}

Control whether font resources are embedded within the HTML file when converting a document to flow-layout HTML:

using (Converter converter = new Converter("sample.docx"))
{
    WebConvertOptions options = new WebConvertOptions
    {
        FixedLayout = false,
        EmbedFontResources = true  // Embed fonts directly in HTML
    };
    converter.Convert("embedded-fonts.html", options);
}

When EmbedFontResources is set to true, the font data is embedded directly within the HTML file as base64, making it self-contained but larger in size. When it is set to false (default), no font data is exported and the browser renders the text with fonts installed on the viewer’s system.

Note: When FixedLayout is enabled (the default), fonts are automatically embedded regardless of the EmbedFontResources setting.

The following code snippet shows how to convert to HTML and control page borders visibility

var source = "sample.docx";
using (var converter = new Converter(source))
{
    var options = new WebConvertOptions
    {
        FixedLayoutShowBorders = false
    };
    converter.Convert("converted.html" , options);
}

Set SlideShow to true to convert a presentation to a single HTML file that plays as a slideshow, with slide transitions and shape animations. Every asset from the deck is inlined into that one file, so no side files or temporary folders are produced.

The property defaults to false, so existing presentation-to-HTML conversions are unchanged.

using (Converter converter = new Converter("presentation.pptx"))
{
    WebConvertOptions options = new WebConvertOptions
    {
        SlideShow = true
    };
    converter.Convert("slideshow.html", options);
}

The following resources are inlined into the HTML as data URIs:

• fonts embedded in the deck, converted to TrueType;
• images, including rasterized metafiles;
• audio and video;
• all CSS and the slideshow JavaScript.

Warning

jQuery and anime.js, which drive navigation and the animations, are loaded from a CDN. The page needs an internet connection to animate and navigate between slides. The slide content itself renders offline.

Setting SlideShow together with any of the following options throws InvalidConvertOptionsException before conversion starts, rather than silently ignoring one of the two settings:

Saving page by page is not supported either. A slideshow is one navigable document, so the Convert overloads that save each page to a separate stream throw NotSupportedException.

• API Reference: WebConvertOptions
• Supported File Formats
• Common Conversion Options