
Convert DocX
=============

.. admonition:: Warning
    :class: tip

    When processing MS-Office files, we first use third-party software to convert the MS-Office files to PDF.

    For certain MS-Office files, the quality of the converted PDF files may not be very high, which can affect the quality of the final output.


Command Line
^^^^^^^^^^^^^

.. code:: python

    # make sure the file have correct suffix
    magic-pdf -p a.docx -o output -m auto


API
^^^^^

.. code:: python

    import os

    from magic_pdf.data.data_reader_writer import FileBasedDataWriter, FileBasedDataReader
    from magic_pdf.model.doc_analyze_by_custom_model import doc_analyze
    from magic_pdf.data.read_api import read_local_office

    # prepare env
    local_image_dir, local_md_dir = "output/images", "output"
    image_dir = str(os.path.basename(local_image_dir))

    os.makedirs(local_image_dir, exist_ok=True)

    image_writer, md_writer = FileBasedDataWriter(local_image_dir), FileBasedDataWriter(
        local_md_dir
    )

    # proc
    ## Create Dataset Instance
    input_file = "some_docx.docx"     # replace with real ms-office file

    input_file_name = input_file.split(".")[0]
    ds = read_local_office(input_file)[0]

    # ocr mode
    ds.apply(doc_analyze, ocr=True).pipe_ocr_mode(image_writer).dump_md(
        md_writer, f"{input_file_name}.md", image_dir
    )

    # txt mode
    ds.apply(doc_analyze, ocr=True).pipe_txt_mode(image_writer).dump_md(
        md_writer, f"{input_file_name}.md", image_dir
    )
