Heading level offset

On this page

Use setHeadingLevelOffset to shift all heading levels in the output by a fixed number. This is useful when embedding converted content inside a larger document where top-level headings are already in use.

Example

import com.groupdocs.markdown.*;

public class HeadingOffsetExample {

    public static void main(String[] args) {
        DocumentConvertOptions options = new DocumentConvertOptions();
        options.setHeadingLevelOffset(2);

        MarkdownConverter.toFile("annual-report.docx", "heading-offset-example.md", options);

        // Source: # Title     → Output: ### Title
        // Source: ## Section  → Output: #### Section
        // Heading levels are clamped to the range 1-6.
    }
}

annual-report.docx is a sample file used in this example. Click here to download it.

![](data:...;base64,[elided])

**Annual Report 2025**

Meridian Outdoor Co.


### **Table of Contents**

Meridian Outdoor Co.	1
[TRUNCATED]

Download full output

On this page

Close
Loading

Analyzing your prompt, please hold on...

An error occurred while retrieving the results. Please refresh the page and try again.