DEV Community

Jeremy K.
Jeremy K.

Posted on

🔍 How to Convert Word to HTML with Java?

#java #programming #html

Converting Word documents to HTML is an indispensable requirement in enterprise development, document management systems, and online document preview scenarios. HTML features cross-platform compatibility, no dedicated reader dependency, and seamless embedding into web pages for direct display.

Within the Java ecosystem, Free Spire.Doc for Java stands out as a free, lightweight document processing library. It enables seamless, non-intrusive conversion from Word DOC/DOCX to HTML without installing Microsoft Office. This guide walks you through the entire implementation, including environment setup, basic conversion code, and advanced HTML export customization.

2. Dependency Setup & Use Cases

2.1 Maven Configuration (Recommended)

Free Spire.Doc for Java is a free community edition built for core Word operations: document reading, writing, and format conversion. It runs on pure Java with no Office dependency and only has mild page limitations. For Maven enterprise projects, add the e-iceblue remote repository and dependency to your pom.xml:

Repository Configuration

<repositories>
    <repository>
        <id>com.e-iceblue</id>
        <name>e-iceblue</name>
        <url>https://repo.e-iceblue.com/nexus/content/groups/public/</url>
    </repository>
</repositories>
<dependency>
    <groupId>e-iceblue</groupId>
    <artifactId>spire.doc.free</artifactId>
    <version>14.3.1</version>
</dependency>
Enter fullscreen mode Exit fullscreen mode

2.2 Common Use Cases

  • Online Document Preview: Convert local Word files to HTML for direct web display
  • Content Migration: Batch convert Word content to standard webpage format
  • Lightweight Document Processing: Small business projects needing free basic Word-to-HTML conversion

2.3 Supported File Formats

  • Input: Word 97-2003 (.doc), Word 2007 and later (.docx)
  • Output: Standard static HTML format

3. Core API for Java Word to HTML Conversion

The entire conversion workflow relies on the Document class and saveToFile method.

Document Class
Serves as the root node of a Word document and represents a complete file. Key methods:

  • Document(): Create a blank document instance
  • loadFromFile(String fileName): Load local Word documents from a file path
  • saveToFile(String fileName, FileFormat fileFormat): Export the loaded document to a specified format

FileFormat Enum
Defines target export formats. Use FileFormat.Html for Word to HTML conversion.

4. Basic Java Code to Convert Word to HTML

Use this ready-to-run code to implement simple DOCX/DOC to HTML conversion:

import com.spire.doc.*;

public class WordToHtml {
    public static void main(String[] args) {
        // Initialize Document object
        Document doc = new Document();

        // Load source Word document
        doc.loadFromFile("sample.docx");

        // Export Word to HTML file
        doc.saveToFile("toHtml.html", FileFormat.Html);

        // Release occupied resources
        doc.dispose();

        System.out.println("Word document conversion completed!");
    }
}
Enter fullscreen mode Exit fullscreen mode

Key Workflow Breakdown

  1. Instantiate: Create an empty Document object
  2. Load File: Import local Word documents into program memory
  3. Export: Parse document content and generate standard HTML files
  4. Resource Release: Free system memory with dispose()

5. Advanced Word to HTML Customization 🚀

Free Spire.Doc for Java provides HtmlExportOptions to customize HTML export settings. You can adjust CSS generation, image embedding, and header/footer output for optimized webpage presentation.

5.1 CSS Style Configuration

  • setCssStyleSheetType(CssStyleSheetType type): Adjust CSS file generation mode
  • CssStyleSheetType.Internal: Embed CSS rules inside the HTML <style> tag
  • CssStyleSheetType.External: Generate an independent external .css file
  • Default Setting: Internal CSS for single self-contained HTML files 
// Embed CSS styles directly into HTML
doc.getHtmlExportOptions().setCssStyleSheetType(CssStyleSheetType.Internal);
Enter fullscreen mode Exit fullscreen mode

5.2 Image Embedding

You have two flexible options to handle Word images during HTML conversion:

Option 1: External Image Storage (Default)
Images are saved to an auto-generated _images subfolder, and HTML references images via relative paths. Ideal for web deployment with large numbers of images.

Option 2: Base64 Embedded Images
Enable Base64 embedding to encode all images directly into the HTML file. This creates a single self-contained HTML file for offline use, though it will increase file size.

// Embed images into HTML with Base64
doc.getHtmlExportOptions().setImageEmbedded(true);
Enter fullscreen mode Exit fullscreen mode

4.3 Enable/Disable Headers & Footers

By default, Word headers and footers are converted into HTML page top and bottom blocks. If you only need to export the main content, you can turn off header and footer export with one line of code:

// Disable header and footer export, convert only body content
doc.getHtmlExportOptions().hasHeadersFooters(false);
Enter fullscreen mode Exit fullscreen mode

Conclusion

This tutorial covers the complete method to convert Word to HTML using Java with a free library. The solution is lightweight, requires no Microsoft Office installation, and fits perfectly for small to medium business projects and online preview systems.

For ultra-large Word files or highly complex layout requirements, you can combine this library with Apache POI to build a customized Java document conversion solution.

Top comments (0)