docx

Use the docx npm library to build documents with Document, Paragraph, and TextRun components, then export with Packer.toBuffer(). It supports styles, tables, lists, images, headers, footers, and tables of contents.

Unpack the document with the provided unpack script, then use the Document library's replace_node, suggest_deletion, revert_insertion, and revert_deletion methods to wrap edits in w:ins and w:del tags. Pack the directory back into a .docx when finished.

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 directly.

Yes, the Document library's add_comment method anchors comments to document nodes and automatically manages comments.xml, commentsExtended, and people.xml infrastructure. You can also reply to existing comments with reply_to_comment.

Common causes include standalone PageBreak elements outside Paragraphs, unicode bullets instead of numbering config, missing ImageRun type parameters, or invalid tracked change nesting. Follow the documented critical rules and run validation on save.