@mtfm/docx-to-html

Provides a converter which converts .docx files (documents created by Microsoft Word) to HTML.

This package is part of the Mutaforma monorepo.

Table of contents

• Installation
• Usage
• API
• License

Installation

npm install @mtfm/docx-to-html

Usage

Minimum example

The conversion result is not persisted to disk, requiring programmatic handling to store or further process the output.

import { DocxToHtmlConverter } from "@mtfm/docx-to-html";

const converter = new DocxToHtmlConverter({
    input: "path/to/the/docx/file.docx",
});

const execOpResult = converter.execute();

if (execOpResult.isErr()) {
    const error = execOpResult.error;
    // Handle error during execution
    return;
}

const finalResult = execOpResult.value;

// Handle the conversion result

Persisting result to disk

To persist the conversion result to disk, simply provide the desired output folder path via the output property of the options object passed to the converter.

If the specified folder structure does not yet exist, it will be automatically created. Furthermore, the conversion result can still be processed programmatically.

import { DocxToHtmlConverter } from "@mtfm/docx-to-html";

const converter = new DocxToHtmlConverter({
    input: "path/to/the/docx/file.docx",
    output: "path/to/output/folder",
});

// Same as in minimum example

Customizing conversion configuration

To customize the default conversion configuration, you can specify the path to a custom configuration file in JSON format using the config property of the options object passed to the converter.

For a comprehensive overview of all available configuration settings and the required structure of the configuration file, please refer to the official Mutaforma documentation.

import { DocxToHtmlConverter } from "@mtfm/docx-to-html";

const converter = new DocxToHtmlConverter({
    input: "path/to/the/docx/file.docx",
    output: "path/to/output/folder",
    config: "path/to/custom/config/file.json",
});

// Same as in minimum example

API

DocxToHtmlConverter

Methods

Name	Parameters	Returns
constructor	IDocumentConverterOpts<...>	DocxToHtmlConverter
execute		Promise<Result<IDocumentConverterResult, Error>>

IDocumentConverterOpts<string | Buffer>

Properties

Name	Type	Mandatory	Description
input	string or Buffer	yes	Either a path to a *.docx file on disk or an already buffered *.docx file
output	string	no	A path to a folder to which the output should be saved
config	string	no	Path to a custom configuration file in JSON format

IDocumentConverterResult

Properties

Name	Type	Mandatory	Description
images	IAsset[]	yes	All images contained within the *.docx file
document	IAsset	yes	The HTML document

IAsset

Properties

Name	Type	Mandatory	Description
id	string	yes	The asset id
data	string	yes	The asset data
dataEncoding	string	yes	The asset data encoding
name	string	yes	The name of the asset
ext	string	yes	The file extension of the asset

License

MIT