HtmlSaveOptions.NavigationMapLevel

HtmlSaveOptions NavigationMapLevel property. Specifies the maximum level of headings populated to the navigation map when exporting to EPUB MOBI or AZW3 formats. Default value is 3.

HtmlSaveOptions.NavigationMapLevel property

Specifies the maximum level of headings populated to the navigation map when exporting to EPUB, MOBI, or AZW3 formats. Default value is 3.

public int NavigationMapLevel { get; set; }

Remarks

The navigation map allows user agents to provide an easy way of navigation through the document structure. Usually navigation points correspond to headings in the document. In order to populate headings up to level N assign this value to NavigationMapLevel.

By default, three levels of headings are populated: paragraphs of styles Heading 1, Heading 2 and Heading 3. You can set this property to a value from 1 to 9 in order to request the corresponding maximum level. Setting it to zero will reduce the navigation map to only the document root or roots of document parts.

Examples

Shows how to specify maximum level of headings populated to the navigation map exported of EPUB.

HtmlSaveOptions htmlSaveOptions = new HtmlSaveOptions(SaveFormat.Epub);
htmlSaveOptions.NavigationMapLevel = 1;

Converter.Create()
    .From(MyDir + "TestSpliter.docx")
    .To(ArtifactsDir + "HtmlSaveOptions.NavigationMapLevel.epub", htmlSaveOptions)
    .Execute();

HtmlSaveOptions.NavigationMapLevel