Convert a Markdown file to HWPX format.

Use this when the user wants to create an HWPX document from a Markdown file WITHOUT providing a reference HWPX template. Generates a complete document with cover page, page headers/footers, heading auto-numbering, native tables, code blocks, lists, and blockquotes.

Analyze an existing HWPX file and return its full structure.

Outputs font definitions, border/fill styles, character styles (charPr), paragraph styles (paraPr), page/margin settings, and the complete body structure including all paragraphs and tables with cell details.

Use this as the first step when the user provides a reference HWPX file for replication or editing.

Build an HWPX file from a template and optional XML overrides.

Workflow:

1. Start from the base template skeleton.

2. Optionally overlay a document-type template (gonmun/report/minutes).

3. Optionally override header.xml (styles) and/or section0.xml (body).

4. Pack as a valid HWPX archive and validate.

When a user provides a reference HWPX, first call analyze_hwpx() and extract_hwpx_xml() to get the header/section XML, then write a new section0.xml with only the required text changes, and pass it here.

Extract header.xml and section0.xml from an HWPX file.

Use this to get the raw XML from a reference HWPX so you can:

• Read the exact charPrIDRef/paraPrIDRef/borderFillIDRef values in use

• Copy the header.xml for reuse in build_hwpx()

• Edit section0.xml text nodes and pass the modified file to build_hwpx()

Validate the structural integrity of an HWPX file.

Checks: valid ZIP, required files, mimetype content/position/compression, and XML well-formedness.

Check that output HWPX has not drifted in page count vs a reference.

Best for SAME-STRUCTURE edits (filling values into a form, replacing text in-place without adding/removing paragraphs or tables). When sections are added, removed, or restructured, expected differences will be reported as failures — in that case use validate_hwpx for integrity checks instead.

Compares paragraph count, table count, table dimensions, explicit page/column breaks, and overall text length between reference and output.

Extract plain text content from an HWPX file.