Search code examples
htmlpython-3.xms-wordconvertersmammoth

Cannot convert DOCX to HTML with Python

I've tried it by using mammoth:

import mammoth

result = mammoth.convert_to_html("MyDocument.docx")
print (result.value)

I don't get an HTML, but this strange code:

kbW7yqZoo4h9pYM6yBxX1QFx2pCoPYflXfieIPbtqpT913Vk7OzcZdEk3eO7TbWjvZNTGilsfmRrPwDvB[...]

I've also tried to use docx2html, but I can't install it. When I run pip install docx2html I get this error:

SyntaxError: Missing parentheses in call to 'print'
Solution

  • Mammoth .docx to HTML converter

    Mammoth is designed to convert .docx documents, such as those created by Microsoft Word, and convert them to HTML. Mammoth aims to produce simple and clean HTML by using semantic information in the document, and ignoring other details. For instance, Mammoth converts any paragraph with the style Heading 1 to h1 elements, rather than attempting to exactly copy the styling (font, text size, colour, etc.) of the heading.

    There's a large mismatch between the structure used by .docx and the structure of HTML, meaning that the conversion is unlikely to be perfect for more complicated documents. Mammoth works best if you only use styles to semantically mark up your document.

    The following features are currently supported:

    • Headings.

    • Lists.

    • Customisable mapping from your own docx styles to HTML. For instance, you could convert WarningHeading to h1.warning by providing an appropriate style mapping.

    • Tables. The formatting of the table itself, such as borders, is currently ignored, but the formatting of the text is treated the same as in the rest of the document.

    • Footnotes and endnotes.

    • Images.

    • Bold, italics, underlines, strikethrough, superscript and subscript.

    • Links.

    • Line breaks.

    • Text boxes. The contents of the text box are treated as a separate paragraph that appears after the paragraph containing the text box.

    • Comments.

    Installation

    pip install mammoth

    Basic conversion

    To convert an existing .docx file to HTML, pass a file-like object to mammoth.convert_to_html. The file should be opened in binary mode. For instance:

    import mammoth

with open("document.docx", "rb") as docx_file:
    result = mammoth.convert_to_html(docx_file)
    html = result.value # The generated HTML
    messages = result.messages # Any messages, such as warnings during conversion

    You can also extract the raw text of the document by using mammoth.extract_raw_text. This will ignore all formatting in the document. Each paragraph is followed by two newlines.

    with open("document.docx", "rb") as docx_file:
    result = mammoth.extract_raw_text(docx_file)
    text = result.value # The raw text
    messages = result.messages # Any messages