docx

Use the docx npm library to build documents with Document, Paragraph, and TextRun components, then export with Packer.toBuffer(). The docx-js.md reference covers styles, tables, lists, images, and headers with required formatting rules.

Unpack the .docx with the provided unpack script, then use the Python Document library to insert <w:ins> and <w:del> elements via replace_node or suggest_deletion. The library auto-injects RSIDs, author, and date attributes, then repack with the pack script.

Convert the document to markdown using pandoc with the --track-changes=all flag to preserve insertions and deletions. For comments, embedded media, or complex formatting, unpack the file and read the raw XML in word/document.xml directly.

Yes, the Document library's add_comment method anchors comments to document nodes and automatically manages comments.xml, commentsExtended.xml, commentsIds.xml, and people.xml infrastructure. It also supports replying to existing comments via reply_to_comment.

Common causes include standalone PageBreak elements outside a Paragraph, missing ImageRun type parameters, unicode bullets instead of numbering config, or invalid tracked change nesting. Follow the critical rules in docx-js.md and ooxml.md, and rely on the library's save validation.