[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-anthropics-skills-skills-docx":3},{"error":4,"detail":5,"metadata":307,"markdownContent":309,"rawMarkdown":304},false,{"repo_full_name":6,"owner":7,"repo_name":8,"repo_forks":9,"skill_path":10,"repo_stars":11,"name":12,"category_id":13,"description":14,"file_tree":15,"skill_md_content":304,"skill_id":305,"skill_key":306},"anthropics/skills","anthropics","skills",10943,"skills/docx",100332,"docx",13,"Use this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation.",[16,21,25],{"name":17,"path":18,"size":19,"type":20},"LICENSE.txt","skills/docx/LICENSE.txt",1467,"file",{"name":22,"path":23,"size":24,"type":20},"SKILL.md","skills/docx/SKILL.md",20084,{"name":26,"path":27,"type":28,"children":29},"scripts","skills/docx/scripts","folder",[30,34,38,42,280],{"name":31,"path":32,"size":33,"type":20},"__init__.py","skills/docx/scripts/__init__.py",1,{"name":35,"path":36,"size":37,"type":20},"accept_changes.py","skills/docx/scripts/accept_changes.py",4051,{"name":39,"path":40,"size":41,"type":20},"comment.py","skills/docx/scripts/comment.py",10694,{"name":43,"path":44,"type":28,"children":45},"office","skills/docx/scripts/office",[46,61,65,245,249,253,257],{"name":47,"path":48,"type":28,"children":49},"helpers","skills/docx/scripts/office/helpers",[50,53,57],{"name":31,"path":51,"size":52,"type":20},"skills/docx/scripts/office/helpers/__init__.py",0,{"name":54,"path":55,"size":56,"type":20},"merge_runs.py","skills/docx/scripts/office/helpers/merge_runs.py",5567,{"name":58,"path":59,"size":60,"type":20},"simplify_redlines.py","skills/docx/scripts/office/helpers/simplify_redlines.py",5754,{"name":62,"path":63,"size":64,"type":20},"pack.py","skills/docx/scripts/office/pack.py",4991,{"name":66,"path":67,"type":28,"children":68},"schemas","skills/docx/scripts/office/schemas",[69,181,205,213],{"name":70,"path":71,"type":28,"children":72},"ISO-IEC29500-4_2016","skills/docx/scripts/office/schemas/ISO-IEC29500-4_2016",[73,77,81,85,89,93,97,101,105,109,113,117,121,125,129,133,137,141,145,149,153,157,161,165,169,173,177],{"name":74,"path":75,"size":76,"type":20},"dml-chart.xsd","skills/docx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-chart.xsd",74984,{"name":78,"path":79,"size":80,"type":20},"dml-chartDrawing.xsd","skills/docx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-chartDrawing.xsd",6956,{"name":82,"path":83,"size":84,"type":20},"dml-diagram.xsd","skills/docx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-diagram.xsd",51302,{"name":86,"path":87,"size":88,"type":20},"dml-lockedCanvas.xsd","skills/docx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-lockedCanvas.xsd",624,{"name":90,"path":91,"size":92,"type":20},"dml-main.xsd","skills/docx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-main.xsd",152039,{"name":94,"path":95,"size":96,"type":20},"dml-picture.xsd","skills/docx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-picture.xsd",1231,{"name":98,"path":99,"size":100,"type":20},"dml-spreadsheetDrawing.xsd","skills/docx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-spreadsheetDrawing.xsd",8862,{"name":102,"path":103,"size":104,"type":20},"dml-wordprocessingDrawing.xsd","skills/docx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-wordprocessingDrawing.xsd",14795,{"name":106,"path":107,"size":108,"type":20},"pml.xsd","skills/docx/scripts/office/schemas/ISO-IEC29500-4_2016/pml.xsd",83612,{"name":110,"path":111,"size":112,"type":20},"shared-additionalCharacteristics.xsd","skills/docx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-additionalCharacteristics.xsd",1269,{"name":114,"path":115,"size":116,"type":20},"shared-bibliography.xsd","skills/docx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-bibliography.xsd",7328,{"name":118,"path":119,"size":120,"type":20},"shared-commonSimpleTypes.xsd","skills/docx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-commonSimpleTypes.xsd",6382,{"name":122,"path":123,"size":124,"type":20},"shared-customXmlDataProperties.xsd","skills/docx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-customXmlDataProperties.xsd",1248,{"name":126,"path":127,"size":128,"type":20},"shared-customXmlSchemaProperties.xsd","skills/docx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-customXmlSchemaProperties.xsd",880,{"name":130,"path":131,"size":132,"type":20},"shared-documentPropertiesCustom.xsd","skills/docx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesCustom.xsd",2608,{"name":134,"path":135,"size":136,"type":20},"shared-documentPropertiesExtended.xsd","skills/docx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesExtended.xsd",3507,{"name":138,"path":139,"size":140,"type":20},"shared-documentPropertiesVariantTypes.xsd","skills/docx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesVariantTypes.xsd",7507,{"name":142,"path":143,"size":144,"type":20},"shared-math.xsd","skills/docx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-math.xsd",23313,{"name":146,"path":147,"size":148,"type":20},"shared-relationshipReference.xsd","skills/docx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-relationshipReference.xsd",1367,{"name":150,"path":151,"size":152,"type":20},"sml.xsd","skills/docx/scripts/office/schemas/ISO-IEC29500-4_2016/sml.xsd",242277,{"name":154,"path":155,"size":156,"type":20},"vml-main.xsd","skills/docx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-main.xsd",26148,{"name":158,"path":159,"size":160,"type":20},"vml-officeDrawing.xsd","skills/docx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-officeDrawing.xsd",25279,{"name":162,"path":163,"size":164,"type":20},"vml-presentationDrawing.xsd","skills/docx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-presentationDrawing.xsd",535,{"name":166,"path":167,"size":168,"type":20},"vml-spreadsheetDrawing.xsd","skills/docx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-spreadsheetDrawing.xsd",5712,{"name":170,"path":171,"size":172,"type":20},"vml-wordprocessingDrawing.xsd","skills/docx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-wordprocessingDrawing.xsd",4010,{"name":174,"path":175,"size":176,"type":20},"wml.xsd","skills/docx/scripts/office/schemas/ISO-IEC29500-4_2016/wml.xsd",171367,{"name":178,"path":179,"size":180,"type":20},"xml.xsd","skills/docx/scripts/office/schemas/ISO-IEC29500-4_2016/xml.xsd",4646,{"name":182,"path":183,"type":28,"children":184},"ecma","skills/docx/scripts/office/schemas/ecma",[185],{"name":186,"path":187,"type":28,"children":188},"fouth-edition","skills/docx/scripts/office/schemas/ecma/fouth-edition",[189,193,197,201],{"name":190,"path":191,"size":192,"type":20},"opc-contentTypes.xsd","skills/docx/scripts/office/schemas/ecma/fouth-edition/opc-contentTypes.xsd",1963,{"name":194,"path":195,"size":196,"type":20},"opc-coreProperties.xsd","skills/docx/scripts/office/schemas/ecma/fouth-edition/opc-coreProperties.xsd",2515,{"name":198,"path":199,"size":200,"type":20},"opc-digSig.xsd","skills/docx/scripts/office/schemas/ecma/fouth-edition/opc-digSig.xsd",2856,{"name":202,"path":203,"size":204,"type":20},"opc-relationships.xsd","skills/docx/scripts/office/schemas/ecma/fouth-edition/opc-relationships.xsd",1344,{"name":206,"path":207,"type":28,"children":208},"mce","skills/docx/scripts/office/schemas/mce",[209],{"name":210,"path":211,"size":212,"type":20},"mc.xsd","skills/docx/scripts/office/schemas/mce/mc.xsd",3127,{"name":214,"path":215,"type":28,"children":216},"microsoft","skills/docx/scripts/office/schemas/microsoft",[217,221,225,229,233,237,241],{"name":218,"path":219,"size":220,"type":20},"wml-2010.xsd","skills/docx/scripts/office/schemas/microsoft/wml-2010.xsd",26549,{"name":222,"path":223,"size":224,"type":20},"wml-2012.xsd","skills/docx/scripts/office/schemas/microsoft/wml-2012.xsd",3745,{"name":226,"path":227,"size":228,"type":20},"wml-2018.xsd","skills/docx/scripts/office/schemas/microsoft/wml-2018.xsd",901,{"name":230,"path":231,"size":232,"type":20},"wml-cex-2018.xsd","skills/docx/scripts/office/schemas/microsoft/wml-cex-2018.xsd",1778,{"name":234,"path":235,"size":236,"type":20},"wml-cid-2016.xsd","skills/docx/scripts/office/schemas/microsoft/wml-cid-2016.xsd",1002,{"name":238,"path":239,"size":240,"type":20},"wml-sdtdatahash-2020.xsd","skills/docx/scripts/office/schemas/microsoft/wml-sdtdatahash-2020.xsd",600,{"name":242,"path":243,"size":244,"type":20},"wml-symex-2015.xsd","skills/docx/scripts/office/schemas/microsoft/wml-symex-2015.xsd",745,{"name":246,"path":247,"size":248,"type":20},"soffice.py","skills/docx/scripts/office/soffice.py",5301,{"name":250,"path":251,"size":252,"type":20},"unpack.py","skills/docx/scripts/office/unpack.py",4052,{"name":254,"path":255,"size":256,"type":20},"validate.py","skills/docx/scripts/office/validate.py",3668,{"name":258,"path":259,"type":28,"children":260},"validators","skills/docx/scripts/office/validators",[261,264,268,272,276],{"name":31,"path":262,"size":263,"type":20},"skills/docx/scripts/office/validators/__init__.py",336,{"name":265,"path":266,"size":267,"type":20},"base.py","skills/docx/scripts/office/validators/base.py",32651,{"name":269,"path":270,"size":271,"type":20},"docx.py","skills/docx/scripts/office/validators/docx.py",16376,{"name":273,"path":274,"size":275,"type":20},"pptx.py","skills/docx/scripts/office/validators/pptx.py",9824,{"name":277,"path":278,"size":279,"type":20},"redlining.py","skills/docx/scripts/office/validators/redlining.py",8918,{"name":281,"path":282,"type":28,"children":283},"templates","skills/docx/scripts/templates",[284,288,292,296,300],{"name":285,"path":286,"size":287,"type":20},"comments.xml","skills/docx/scripts/templates/comments.xml",2603,{"name":289,"path":290,"size":291,"type":20},"commentsExtended.xml","skills/docx/scripts/templates/commentsExtended.xml",2611,{"name":293,"path":294,"size":295,"type":20},"commentsExtensible.xml","skills/docx/scripts/templates/commentsExtensible.xml",2707,{"name":297,"path":298,"size":299,"type":20},"commentsIds.xml","skills/docx/scripts/templates/commentsIds.xml",2619,{"name":301,"path":302,"size":303,"type":20},"people.xml","skills/docx/scripts/templates/people.xml",115,"---\nname: docx\ndescription: \"Use this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation.\"\nlicense: Proprietary. LICENSE.txt has complete terms\n---\n\n# DOCX creation, editing, and analysis\n\n## Overview\n\nA .docx file is a ZIP archive containing XML files.\n\n## Quick Reference\n\n| Task | Approach |\n|------|----------|\n| Read/analyze content | `pandoc` or unpack for raw XML |\n| Create new document | Use `docx-js` - see Creating New Documents below |\n| Edit existing document | Unpack → edit XML → repack - see Editing Existing Documents below |\n\n### Converting .doc to .docx\n\nLegacy `.doc` files must be converted before editing:\n\n```bash\npython scripts/office/soffice.py --headless --convert-to docx document.doc\n```\n\n### Reading Content\n\n```bash\n# Text extraction with tracked changes\npandoc --track-changes=all document.docx -o output.md\n\n# Raw XML access\npython scripts/office/unpack.py document.docx unpacked/\n```\n\n### Converting to Images\n\n```bash\npython scripts/office/soffice.py --headless --convert-to pdf document.docx\npdftoppm -jpeg -r 150 document.pdf page\n```\n\n### Accepting Tracked Changes\n\nTo produce a clean document with all tracked changes accepted (requires LibreOffice):\n\n```bash\npython scripts/accept_changes.py input.docx output.docx\n```\n\n---\n\n## Creating New Documents\n\nGenerate .docx files with JavaScript, then validate. Install: `npm install -g docx`\n\n### Setup\n```javascript\nconst { Document, Packer, Paragraph, TextRun, Table, TableRow, TableCell, ImageRun,\n        Header, Footer, AlignmentType, PageOrientation, LevelFormat, ExternalHyperlink,\n        InternalHyperlink, Bookmark, FootnoteReferenceRun, PositionalTab,\n        PositionalTabAlignment, PositionalTabRelativeTo, PositionalTabLeader,\n        TabStopType, TabStopPosition, Column, SectionType,\n        TableOfContents, HeadingLevel, BorderStyle, WidthType, ShadingType,\n        VerticalAlign, PageNumber, PageBreak } = require('docx');\n\nconst doc = new Document({ sections: [{ children: [/* content */] }] });\nPacker.toBuffer(doc).then(buffer => fs.writeFileSync(\"doc.docx\", buffer));\n```\n\n### Validation\nAfter creating the file, validate it. If validation fails, unpack, fix the XML, and repack.\n```bash\npython scripts/office/validate.py doc.docx\n```\n\n### Page Size\n\n```javascript\n// CRITICAL: docx-js defaults to A4, not US Letter\n// Always set page size explicitly for consistent results\nsections: [{\n  properties: {\n    page: {\n      size: {\n        width: 12240,   // 8.5 inches in DXA\n        height: 15840   // 11 inches in DXA\n      },\n      margin: { top: 1440, right: 1440, bottom: 1440, left: 1440 } // 1 inch margins\n    }\n  },\n  children: [/* content */]\n}]\n```\n\n**Common page sizes (DXA units, 1440 DXA = 1 inch):**\n\n| Paper | Width | Height | Content Width (1\" margins) |\n|-------|-------|--------|---------------------------|\n| US Letter | 12,240 | 15,840 | 9,360 |\n| A4 (default) | 11,906 | 16,838 | 9,026 |\n\n**Landscape orientation:** docx-js swaps width/height internally, so pass portrait dimensions and let it handle the swap:\n```javascript\nsize: {\n  width: 12240,   // Pass SHORT edge as width\n  height: 15840,  // Pass LONG edge as height\n  orientation: PageOrientation.LANDSCAPE  // docx-js swaps them in the XML\n},\n// Content width = 15840 - left margin - right margin (uses the long edge)\n```\n\n### Styles (Override Built-in Headings)\n\nUse Arial as the default font (universally supported). Keep titles black for readability.\n\n```javascript\nconst doc = new Document({\n  styles: {\n    default: { document: { run: { font: \"Arial\", size: 24 } } }, // 12pt default\n    paragraphStyles: [\n      // IMPORTANT: Use exact IDs to override built-in styles\n      { id: \"Heading1\", name: \"Heading 1\", basedOn: \"Normal\", next: \"Normal\", quickFormat: true,\n        run: { size: 32, bold: true, font: \"Arial\" },\n        paragraph: { spacing: { before: 240, after: 240 }, outlineLevel: 0 } }, // outlineLevel required for TOC\n      { id: \"Heading2\", name: \"Heading 2\", basedOn: \"Normal\", next: \"Normal\", quickFormat: true,\n        run: { size: 28, bold: true, font: \"Arial\" },\n        paragraph: { spacing: { before: 180, after: 180 }, outlineLevel: 1 } },\n    ]\n  },\n  sections: [{\n    children: [\n      new Paragraph({ heading: HeadingLevel.HEADING_1, children: [new TextRun(\"Title\")] }),\n    ]\n  }]\n});\n```\n\n### Lists (NEVER use unicode bullets)\n\n```javascript\n// ❌ WRONG - never manually insert bullet characters\nnew Paragraph({ children: [new TextRun(\"• Item\")] })  // BAD\nnew Paragraph({ children: [new TextRun(\"\\u2022 Item\")] })  // BAD\n\n// ✅ CORRECT - use numbering config with LevelFormat.BULLET\nconst doc = new Document({\n  numbering: {\n    config: [\n      { reference: \"bullets\",\n        levels: [{ level: 0, format: LevelFormat.BULLET, text: \"•\", alignment: AlignmentType.LEFT,\n          style: { paragraph: { indent: { left: 720, hanging: 360 } } } }] },\n      { reference: \"numbers\",\n        levels: [{ level: 0, format: LevelFormat.DECIMAL, text: \"%1.\", alignment: AlignmentType.LEFT,\n          style: { paragraph: { indent: { left: 720, hanging: 360 } } } }] },\n    ]\n  },\n  sections: [{\n    children: [\n      new Paragraph({ numbering: { reference: \"bullets\", level: 0 },\n        children: [new TextRun(\"Bullet item\")] }),\n      new Paragraph({ numbering: { reference: \"numbers\", level: 0 },\n        children: [new TextRun(\"Numbered item\")] }),\n    ]\n  }]\n});\n\n// ⚠️ Each reference creates INDEPENDENT numbering\n// Same reference = continues (1,2,3 then 4,5,6)\n// Different reference = restarts (1,2,3 then 1,2,3)\n```\n\n### Tables\n\n**CRITICAL: Tables need dual widths** - set both `columnWidths` on the table AND `width` on each cell. Without both, tables render incorrectly on some platforms.\n\n```javascript\n// CRITICAL: Always set table width for consistent rendering\n// CRITICAL: Use ShadingType.CLEAR (not SOLID) to prevent black backgrounds\nconst border = { style: BorderStyle.SINGLE, size: 1, color: \"CCCCCC\" };\nconst borders = { top: border, bottom: border, left: border, right: border };\n\nnew Table({\n  width: { size: 9360, type: WidthType.DXA }, // Always use DXA (percentages break in Google Docs)\n  columnWidths: [4680, 4680], // Must sum to table width (DXA: 1440 = 1 inch)\n  rows: [\n    new TableRow({\n      children: [\n        new TableCell({\n          borders,\n          width: { size: 4680, type: WidthType.DXA }, // Also set on each cell\n          shading: { fill: \"D5E8F0\", type: ShadingType.CLEAR }, // CLEAR not SOLID\n          margins: { top: 80, bottom: 80, left: 120, right: 120 }, // Cell padding (internal, not added to width)\n          children: [new Paragraph({ children: [new TextRun(\"Cell\")] })]\n        })\n      ]\n    })\n  ]\n})\n```\n\n**Table width calculation:**\n\nAlways use `WidthType.DXA` — `WidthType.PERCENTAGE` breaks in Google Docs.\n\n```javascript\n// Table width = sum of columnWidths = content width\n// US Letter with 1\" margins: 12240 - 2880 = 9360 DXA\nwidth: { size: 9360, type: WidthType.DXA },\ncolumnWidths: [7000, 2360]  // Must sum to table width\n```\n\n**Width rules:**\n- **Always use `WidthType.DXA`** — never `WidthType.PERCENTAGE` (incompatible with Google Docs)\n- Table width must equal the sum of `columnWidths`\n- Cell `width` must match corresponding `columnWidth`\n- Cell `margins` are internal padding - they reduce content area, not add to cell width\n- For full-width tables: use content width (page width minus left and right margins)\n\n### Images\n\n```javascript\n// CRITICAL: type parameter is REQUIRED\nnew Paragraph({\n  children: [new ImageRun({\n    type: \"png\", // Required: png, jpg, jpeg, gif, bmp, svg\n    data: fs.readFileSync(\"image.png\"),\n    transformation: { width: 200, height: 150 },\n    altText: { title: \"Title\", description: \"Desc\", name: \"Name\" } // All three required\n  })]\n})\n```\n\n### Page Breaks\n\n```javascript\n// CRITICAL: PageBreak must be inside a Paragraph\nnew Paragraph({ children: [new PageBreak()] })\n\n// Or use pageBreakBefore\nnew Paragraph({ pageBreakBefore: true, children: [new TextRun(\"New page\")] })\n```\n\n### Hyperlinks\n\n```javascript\n// External link\nnew Paragraph({\n  children: [new ExternalHyperlink({\n    children: [new TextRun({ text: \"Click here\", style: \"Hyperlink\" })],\n    link: \"https://example.com\",\n  })]\n})\n\n// Internal link (bookmark + reference)\n// 1. Create bookmark at destination\nnew Paragraph({ heading: HeadingLevel.HEADING_1, children: [\n  new Bookmark({ id: \"chapter1\", children: [new TextRun(\"Chapter 1\")] }),\n]})\n// 2. Link to it\nnew Paragraph({ children: [new InternalHyperlink({\n  children: [new TextRun({ text: \"See Chapter 1\", style: \"Hyperlink\" })],\n  anchor: \"chapter1\",\n})]})\n```\n\n### Footnotes\n\n```javascript\nconst doc = new Document({\n  footnotes: {\n    1: { children: [new Paragraph(\"Source: Annual Report 2024\")] },\n    2: { children: [new Paragraph(\"See appendix for methodology\")] },\n  },\n  sections: [{\n    children: [new Paragraph({\n      children: [\n        new TextRun(\"Revenue grew 15%\"),\n        new FootnoteReferenceRun(1),\n        new TextRun(\" using adjusted metrics\"),\n        new FootnoteReferenceRun(2),\n      ],\n    })]\n  }]\n});\n```\n\n### Tab Stops\n\n```javascript\n// Right-align text on same line (e.g., date opposite a title)\nnew Paragraph({\n  children: [\n    new TextRun(\"Company Name\"),\n    new TextRun(\"\\tJanuary 2025\"),\n  ],\n  tabStops: [{ type: TabStopType.RIGHT, position: TabStopPosition.MAX }],\n})\n\n// Dot leader (e.g., TOC-style)\nnew Paragraph({\n  children: [\n    new TextRun(\"Introduction\"),\n    new TextRun({ children: [\n      new PositionalTab({\n        alignment: PositionalTabAlignment.RIGHT,\n        relativeTo: PositionalTabRelativeTo.MARGIN,\n        leader: PositionalTabLeader.DOT,\n      }),\n      \"3\",\n    ]}),\n  ],\n})\n```\n\n### Multi-Column Layouts\n\n```javascript\n// Equal-width columns\nsections: [{\n  properties: {\n    column: {\n      count: 2,          // number of columns\n      space: 720,        // gap between columns in DXA (720 = 0.5 inch)\n      equalWidth: true,\n      separate: true,    // vertical line between columns\n    },\n  },\n  children: [/* content flows naturally across columns */]\n}]\n\n// Custom-width columns (equalWidth must be false)\nsections: [{\n  properties: {\n    column: {\n      equalWidth: false,\n      children: [\n        new Column({ width: 5400, space: 720 }),\n        new Column({ width: 3240 }),\n      ],\n    },\n  },\n  children: [/* content */]\n}]\n```\n\nForce a column break with a new section using `type: SectionType.NEXT_COLUMN`.\n\n### Table of Contents\n\n```javascript\n// CRITICAL: Headings must use HeadingLevel ONLY - no custom styles\nnew TableOfContents(\"Table of Contents\", { hyperlink: true, headingStyleRange: \"1-3\" })\n```\n\n### Headers/Footers\n\n```javascript\nsections: [{\n  properties: {\n    page: { margin: { top: 1440, right: 1440, bottom: 1440, left: 1440 } } // 1440 = 1 inch\n  },\n  headers: {\n    default: new Header({ children: [new Paragraph({ children: [new TextRun(\"Header\")] })] })\n  },\n  footers: {\n    default: new Footer({ children: [new Paragraph({\n      children: [new TextRun(\"Page \"), new TextRun({ children: [PageNumber.CURRENT] })]\n    })] })\n  },\n  children: [/* content */]\n}]\n```\n\n### Critical Rules for docx-js\n\n- **Set page size explicitly** - docx-js defaults to A4; use US Letter (12240 x 15840 DXA) for US documents\n- **Landscape: pass portrait dimensions** - docx-js swaps width/height internally; pass short edge as `width`, long edge as `height`, and set `orientation: PageOrientation.LANDSCAPE`\n- **Never use `\\n`** - use separate Paragraph elements\n- **Never use unicode bullets** - use `LevelFormat.BULLET` with numbering config\n- **PageBreak must be in Paragraph** - standalone creates invalid XML\n- **ImageRun requires `type`** - always specify png/jpg/etc\n- **Always set table `width` with DXA** - never use `WidthType.PERCENTAGE` (breaks in Google Docs)\n- **Tables need dual widths** - `columnWidths` array AND cell `width`, both must match\n- **Table width = sum of columnWidths** - for DXA, ensure they add up exactly\n- **Always add cell margins** - use `margins: { top: 80, bottom: 80, left: 120, right: 120 }` for readable padding\n- **Use `ShadingType.CLEAR`** - never SOLID for table shading\n- **Never use tables as dividers/rules** - cells have minimum height and render as empty boxes (including in headers/footers); use `border: { bottom: { style: BorderStyle.SINGLE, size: 6, color: \"2E75B6\", space: 1 } }` on a Paragraph instead. For two-column footers, use tab stops (see Tab Stops section), not tables\n- **TOC requires HeadingLevel only** - no custom styles on heading paragraphs\n- **Override built-in styles** - use exact IDs: \"Heading1\", \"Heading2\", etc.\n- **Include `outlineLevel`** - required for TOC (0 for H1, 1 for H2, etc.)\n\n---\n\n## Editing Existing Documents\n\n**Follow all 3 steps in order.**\n\n### Step 1: Unpack\n```bash\npython scripts/office/unpack.py document.docx unpacked/\n```\nExtracts XML, pretty-prints, merges adjacent runs, and converts smart quotes to XML entities (`“` etc.) so they survive editing. Use `--merge-runs false` to skip run merging.\n\n### Step 2: Edit XML\n\nEdit files in `unpacked/word/`. See XML Reference below for patterns.\n\n**Use \"Claude\" as the author** for tracked changes and comments, unless the user explicitly requests use of a different name.\n\n**Use the Edit tool directly for string replacement. Do not write Python scripts.** Scripts introduce unnecessary complexity. The Edit tool shows exactly what is being replaced.\n\n**CRITICAL: Use smart quotes for new content.** When adding text with apostrophes or quotes, use XML entities to produce smart quotes:\n```xml\n\u003C!-- Use these entities for professional typography -->\n\u003Cw:t>Here’s a quote: “Hello”\u003C/w:t>\n```\n| Entity | Character |\n|--------|-----------|\n| `‘` | ‘ (left single) |\n| `’` | ’ (right single / apostrophe) |\n| `“` | “ (left double) |\n| `”` | ” (right double) |\n\n**Adding comments:** Use `comment.py` to handle boilerplate across multiple XML files (text must be pre-escaped XML):\n```bash\npython scripts/comment.py unpacked/ 0 \"Comment text with & and ’\"\npython scripts/comment.py unpacked/ 1 \"Reply text\" --parent 0  # reply to comment 0\npython scripts/comment.py unpacked/ 0 \"Text\" --author \"Custom Author\"  # custom author name\n```\nThen add markers to document.xml (see Comments in XML Reference).\n\n### Step 3: Pack\n```bash\npython scripts/office/pack.py unpacked/ output.docx --original document.docx\n```\nValidates with auto-repair, condenses XML, and creates DOCX. Use `--validate false` to skip.\n\n**Auto-repair will fix:**\n- `durableId` >= 0x7FFFFFFF (regenerates valid ID)\n- Missing `xml:space=\"preserve\"` on `\u003Cw:t>` with whitespace\n\n**Auto-repair won't fix:**\n- Malformed XML, invalid element nesting, missing relationships, schema violations\n\n### Common Pitfalls\n\n- **Replace entire `\u003Cw:r>` elements**: When adding tracked changes, replace the whole `\u003Cw:r>...\u003C/w:r>` block with `\u003Cw:del>...\u003Cw:ins>...` as siblings. Don't inject tracked change tags inside a run.\n- **Preserve `\u003Cw:rPr>` formatting**: Copy the original run's `\u003Cw:rPr>` block into your tracked change runs to maintain bold, font size, etc.\n\n---\n\n## XML Reference\n\n### Schema Compliance\n\n- **Element order in `\u003Cw:pPr>`**: `\u003Cw:pStyle>`, `\u003Cw:numPr>`, `\u003Cw:spacing>`, `\u003Cw:ind>`, `\u003Cw:jc>`, `\u003Cw:rPr>` last\n- **Whitespace**: Add `xml:space=\"preserve\"` to `\u003Cw:t>` with leading/trailing spaces\n- **RSIDs**: Must be 8-digit hex (e.g., `00AB1234`)\n\n### Tracked Changes\n\n**Insertion:**\n```xml\n\u003Cw:ins w:id=\"1\" w:author=\"Claude\" w:date=\"2025-01-01T00:00:00Z\">\n  \u003Cw:r>\u003Cw:t>inserted text\u003C/w:t>\u003C/w:r>\n\u003C/w:ins>\n```\n\n**Deletion:**\n```xml\n\u003Cw:del w:id=\"2\" w:author=\"Claude\" w:date=\"2025-01-01T00:00:00Z\">\n  \u003Cw:r>\u003Cw:delText>deleted text\u003C/w:delText>\u003C/w:r>\n\u003C/w:del>\n```\n\n**Inside `\u003Cw:del>`**: Use `\u003Cw:delText>` instead of `\u003Cw:t>`, and `\u003Cw:delInstrText>` instead of `\u003Cw:instrText>`.\n\n**Minimal edits** - only mark what changes:\n```xml\n\u003C!-- Change \"30 days\" to \"60 days\" -->\n\u003Cw:r>\u003Cw:t>The term is \u003C/w:t>\u003C/w:r>\n\u003Cw:del w:id=\"1\" w:author=\"Claude\" w:date=\"...\">\n  \u003Cw:r>\u003Cw:delText>30\u003C/w:delText>\u003C/w:r>\n\u003C/w:del>\n\u003Cw:ins w:id=\"2\" w:author=\"Claude\" w:date=\"...\">\n  \u003Cw:r>\u003Cw:t>60\u003C/w:t>\u003C/w:r>\n\u003C/w:ins>\n\u003Cw:r>\u003Cw:t> days.\u003C/w:t>\u003C/w:r>\n```\n\n**Deleting entire paragraphs/list items** - when removing ALL content from a paragraph, also mark the paragraph mark as deleted so it merges with the next paragraph. Add `\u003Cw:del/>` inside `\u003Cw:pPr>\u003Cw:rPr>`:\n```xml\n\u003Cw:p>\n  \u003Cw:pPr>\n    \u003Cw:numPr>...\u003C/w:numPr>  \u003C!-- list numbering if present -->\n    \u003Cw:rPr>\n      \u003Cw:del w:id=\"1\" w:author=\"Claude\" w:date=\"2025-01-01T00:00:00Z\"/>\n    \u003C/w:rPr>\n  \u003C/w:pPr>\n  \u003Cw:del w:id=\"2\" w:author=\"Claude\" w:date=\"2025-01-01T00:00:00Z\">\n    \u003Cw:r>\u003Cw:delText>Entire paragraph content being deleted...\u003C/w:delText>\u003C/w:r>\n  \u003C/w:del>\n\u003C/w:p>\n```\nWithout the `\u003Cw:del/>` in `\u003Cw:pPr>\u003Cw:rPr>`, accepting changes leaves an empty paragraph/list item.\n\n**Rejecting another author's insertion** - nest deletion inside their insertion:\n```xml\n\u003Cw:ins w:author=\"Jane\" w:id=\"5\">\n  \u003Cw:del w:author=\"Claude\" w:id=\"10\">\n    \u003Cw:r>\u003Cw:delText>their inserted text\u003C/w:delText>\u003C/w:r>\n  \u003C/w:del>\n\u003C/w:ins>\n```\n\n**Restoring another author's deletion** - add insertion after (don't modify their deletion):\n```xml\n\u003Cw:del w:author=\"Jane\" w:id=\"5\">\n  \u003Cw:r>\u003Cw:delText>deleted text\u003C/w:delText>\u003C/w:r>\n\u003C/w:del>\n\u003Cw:ins w:author=\"Claude\" w:id=\"10\">\n  \u003Cw:r>\u003Cw:t>deleted text\u003C/w:t>\u003C/w:r>\n\u003C/w:ins>\n```\n\n### Comments\n\nAfter running `comment.py` (see Step 2), add markers to document.xml. For replies, use `--parent` flag and nest markers inside the parent's.\n\n**CRITICAL: `\u003Cw:commentRangeStart>` and `\u003Cw:commentRangeEnd>` are siblings of `\u003Cw:r>`, never inside `\u003Cw:r>`.**\n\n```xml\n\u003C!-- Comment markers are direct children of w:p, never inside w:r -->\n\u003Cw:commentRangeStart w:id=\"0\"/>\n\u003Cw:del w:id=\"1\" w:author=\"Claude\" w:date=\"2025-01-01T00:00:00Z\">\n  \u003Cw:r>\u003Cw:delText>deleted\u003C/w:delText>\u003C/w:r>\n\u003C/w:del>\n\u003Cw:r>\u003Cw:t> more text\u003C/w:t>\u003C/w:r>\n\u003Cw:commentRangeEnd w:id=\"0\"/>\n\u003Cw:r>\u003Cw:rPr>\u003Cw:rStyle w:val=\"CommentReference\"/>\u003C/w:rPr>\u003Cw:commentReference w:id=\"0\"/>\u003C/w:r>\n\n\u003C!-- Comment 0 with reply 1 nested inside -->\n\u003Cw:commentRangeStart w:id=\"0\"/>\n  \u003Cw:commentRangeStart w:id=\"1\"/>\n  \u003Cw:r>\u003Cw:t>text\u003C/w:t>\u003C/w:r>\n  \u003Cw:commentRangeEnd w:id=\"1\"/>\n\u003Cw:commentRangeEnd w:id=\"0\"/>\n\u003Cw:r>\u003Cw:rPr>\u003Cw:rStyle w:val=\"CommentReference\"/>\u003C/w:rPr>\u003Cw:commentReference w:id=\"0\"/>\u003C/w:r>\n\u003Cw:r>\u003Cw:rPr>\u003Cw:rStyle w:val=\"CommentReference\"/>\u003C/w:rPr>\u003Cw:commentReference w:id=\"1\"/>\u003C/w:r>\n```\n\n### Images\n\n1. Add image file to `word/media/`\n2. Add relationship to `word/_rels/document.xml.rels`:\n```xml\n\u003CRelationship Id=\"rId5\" Type=\".../image\" Target=\"media/image1.png\"/>\n```\n3. Add content type to `[Content_Types].xml`:\n```xml\n\u003CDefault Extension=\"png\" ContentType=\"image/png\"/>\n```\n4. Reference in document.xml:\n```xml\n\u003Cw:drawing>\n  \u003Cwp:inline>\n    \u003Cwp:extent cx=\"914400\" cy=\"914400\"/>  \u003C!-- EMUs: 914400 = 1 inch -->\n    \u003Ca:graphic>\n      \u003Ca:graphicData uri=\".../picture\">\n        \u003Cpic:pic>\n          \u003Cpic:blipFill>\u003Ca:blip r:embed=\"rId5\"/>\u003C/pic:blipFill>\n        \u003C/pic:pic>\n      \u003C/a:graphicData>\n    \u003C/a:graphic>\n  \u003C/wp:inline>\n\u003C/w:drawing>\n```\n\n---\n\n## Dependencies\n\n- **pandoc**: Text extraction\n- **docx**: `npm install -g docx` (new documents)\n- **LibreOffice**: PDF conversion (auto-configured for sandboxed environments via `scripts/office/soffice.py`)\n- **Poppler**: `pdftoppm` for images\n","22dbdab2-7e47-5e4a-b96c-b4cff1141b12","anthropics-skills-skills-docx",{"name":12,"description":14,"license":308},"Proprietary. LICENSE.txt has complete terms","\u003Ch1>DOCX creation, editing, and analysis\u003C/h1>\n\u003Ch2>Overview\u003C/h2>\n\u003Cp>A .docx file is a ZIP archive containing XML files.\u003C/p>\n\u003Ch2>Quick Reference\u003C/h2>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Task\u003C/th>\n\u003Cth>Approach\u003C/th>\n\u003C/tr>\n\u003C/thead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>Read/analyze content\u003C/td>\n\u003Ctd>\u003Ccode>pandoc\u003C/code> or unpack for raw XML\u003C/td>\n\u003C/tr>\n\u003Ctr>\n\u003Ctd>Create new document\u003C/td>\n\u003Ctd>Use \u003Ccode>docx-js\u003C/code> - see Creating New Documents below\u003C/td>\n\u003C/tr>\n\u003Ctr>\n\u003Ctd>Edit existing document\u003C/td>\n\u003Ctd>Unpack → edit XML → repack - see Editing Existing Documents below\u003C/td>\n\u003C/tr>\n\u003C/tbody>\u003C/table>\n\u003Ch3>Converting .doc to .docx\u003C/h3>\n\u003Cp>Legacy \u003Ccode>.doc\u003C/code> files must be converted before editing:\u003C/p>\n\u003Cdiv class=\"md-code-block\">\u003Cdiv class=\"md-code-lang\">bash\u003C/div>\u003Cpre>\u003Ccode class=\"hljs language-bash\">python scripts/office/soffice.py --headless --convert-to docx document.doc\u003C/code>\u003C/pre>\u003C/div>\u003Ch3>Reading Content\u003C/h3>\n\u003Cdiv class=\"md-code-block\">\u003Cdiv class=\"md-code-lang\">bash\u003C/div>\u003Cpre>\u003Ccode class=\"hljs language-bash\">\u003Cspan class=\"hljs-comment\"># Text extraction with tracked changes\u003C/span>\npandoc --track-changes=all document.docx -o output.md\n\n\u003Cspan class=\"hljs-comment\"># Raw XML access\u003C/span>\npython scripts/office/unpack.py document.docx unpacked/\u003C/code>\u003C/pre>\u003C/div>\u003Ch3>Converting to Images\u003C/h3>\n\u003Cdiv class=\"md-code-block\">\u003Cdiv class=\"md-code-lang\">bash\u003C/div>\u003Cpre>\u003Ccode class=\"hljs language-bash\">python scripts/office/soffice.py --headless --convert-to pdf document.docx\npdftoppm -jpeg -r 150 document.pdf page\u003C/code>\u003C/pre>\u003C/div>\u003Ch3>Accepting Tracked Changes\u003C/h3>\n\u003Cp>To produce a clean document with all tracked changes accepted (requires LibreOffice):\u003C/p>\n\u003Cdiv class=\"md-code-block\">\u003Cdiv class=\"md-code-lang\">bash\u003C/div>\u003Cpre>\u003Ccode class=\"hljs language-bash\">python scripts/accept_changes.py input.docx output.docx\u003C/code>\u003C/pre>\u003C/div>\u003Chr>\n\u003Ch2>Creating New Documents\u003C/h2>\n\u003Cp>Generate .docx files with JavaScript, then validate. Install: \u003Ccode>npm install -g docx\u003C/code>\u003C/p>\n\u003Ch3>Setup\u003C/h3>\n\u003Cdiv class=\"md-code-block\">\u003Cdiv class=\"md-code-lang\">javascript\u003C/div>\u003Cpre>\u003Ccode class=\"hljs language-javascript\">\u003Cspan class=\"hljs-keyword\">const\u003C/span> { \u003Cspan class=\"hljs-title class_\">Document\u003C/span>, \u003Cspan class=\"hljs-title class_\">Packer\u003C/span>, \u003Cspan class=\"hljs-title class_\">Paragraph\u003C/span>, \u003Cspan class=\"hljs-title class_\">TextRun\u003C/span>, \u003Cspan class=\"hljs-title class_\">Table\u003C/span>, \u003Cspan class=\"hljs-title class_\">TableRow\u003C/span>, \u003Cspan class=\"hljs-title class_\">TableCell\u003C/span>, \u003Cspan class=\"hljs-title class_\">ImageRun\u003C/span>,\n        \u003Cspan class=\"hljs-title class_\">Header\u003C/span>, \u003Cspan class=\"hljs-title class_\">Footer\u003C/span>, \u003Cspan class=\"hljs-title class_\">AlignmentType\u003C/span>, \u003Cspan class=\"hljs-title class_\">PageOrientation\u003C/span>, \u003Cspan class=\"hljs-title class_\">LevelFormat\u003C/span>, \u003Cspan class=\"hljs-title class_\">ExternalHyperlink\u003C/span>,\n        \u003Cspan class=\"hljs-title class_\">InternalHyperlink\u003C/span>, \u003Cspan class=\"hljs-title class_\">Bookmark\u003C/span>, \u003Cspan class=\"hljs-title class_\">FootnoteReferenceRun\u003C/span>, \u003Cspan class=\"hljs-title class_\">PositionalTab\u003C/span>,\n        \u003Cspan class=\"hljs-title class_\">PositionalTabAlignment\u003C/span>, \u003Cspan class=\"hljs-title class_\">PositionalTabRelativeTo\u003C/span>, \u003Cspan class=\"hljs-title class_\">PositionalTabLeader\u003C/span>,\n        \u003Cspan class=\"hljs-title class_\">TabStopType\u003C/span>, \u003Cspan class=\"hljs-title class_\">TabStopPosition\u003C/span>, \u003Cspan class=\"hljs-title class_\">Column\u003C/span>, \u003Cspan class=\"hljs-title class_\">SectionType\u003C/span>,\n        \u003Cspan class=\"hljs-title class_\">TableOfContents\u003C/span>, \u003Cspan class=\"hljs-title class_\">HeadingLevel\u003C/span>, \u003Cspan class=\"hljs-title class_\">BorderStyle\u003C/span>, \u003Cspan class=\"hljs-title class_\">WidthType\u003C/span>, \u003Cspan class=\"hljs-title class_\">ShadingType\u003C/span>,\n        \u003Cspan class=\"hljs-title class_\">VerticalAlign\u003C/span>, \u003Cspan class=\"hljs-title class_\">PageNumber\u003C/span>, \u003Cspan class=\"hljs-title class_\">PageBreak\u003C/span> } = \u003Cspan class=\"hljs-built_in\">require\u003C/span>(\u003Cspan class=\"hljs-string\">'docx'\u003C/span>);\n\n\u003Cspan class=\"hljs-keyword\">const\u003C/span> doc = \u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">Document\u003C/span>({ \u003Cspan class=\"hljs-attr\">sections\u003C/span>: [{ \u003Cspan class=\"hljs-attr\">children\u003C/span>: [\u003Cspan class=\"hljs-comment\">/* content */\u003C/span>] }] });\n\u003Cspan class=\"hljs-title class_\">Packer\u003C/span>.\u003Cspan class=\"hljs-title function_\">toBuffer\u003C/span>(doc).\u003Cspan class=\"hljs-title function_\">then\u003C/span>(\u003Cspan class=\"hljs-function\">\u003Cspan class=\"hljs-params\">buffer\u003C/span> =>\u003C/span> fs.\u003Cspan class=\"hljs-title function_\">writeFileSync\u003C/span>(\u003Cspan class=\"hljs-string\">"doc.docx"\u003C/span>, buffer));\u003C/code>\u003C/pre>\u003C/div>\u003Ch3>Validation\u003C/h3>\n\u003Cp>After creating the file, validate it. If validation fails, unpack, fix the XML, and repack.\u003C/p>\n\u003Cdiv class=\"md-code-block\">\u003Cdiv class=\"md-code-lang\">bash\u003C/div>\u003Cpre>\u003Ccode class=\"hljs language-bash\">python scripts/office/validate.py doc.docx\u003C/code>\u003C/pre>\u003C/div>\u003Ch3>Page Size\u003C/h3>\n\u003Cdiv class=\"md-code-block\">\u003Cdiv class=\"md-code-lang\">javascript\u003C/div>\u003Cpre>\u003Ccode class=\"hljs language-javascript\">\u003Cspan class=\"hljs-comment\">// CRITICAL: docx-js defaults to A4, not US Letter\u003C/span>\n\u003Cspan class=\"hljs-comment\">// Always set page size explicitly for consistent results\u003C/span>\n\u003Cspan class=\"hljs-attr\">sections\u003C/span>: [{\n  \u003Cspan class=\"hljs-attr\">properties\u003C/span>: {\n    \u003Cspan class=\"hljs-attr\">page\u003C/span>: {\n      \u003Cspan class=\"hljs-attr\">size\u003C/span>: {\n        \u003Cspan class=\"hljs-attr\">width\u003C/span>: \u003Cspan class=\"hljs-number\">12240\u003C/span>,   \u003Cspan class=\"hljs-comment\">// 8.5 inches in DXA\u003C/span>\n        \u003Cspan class=\"hljs-attr\">height\u003C/span>: \u003Cspan class=\"hljs-number\">15840\u003C/span>   \u003Cspan class=\"hljs-comment\">// 11 inches in DXA\u003C/span>\n      },\n      \u003Cspan class=\"hljs-attr\">margin\u003C/span>: { \u003Cspan class=\"hljs-attr\">top\u003C/span>: \u003Cspan class=\"hljs-number\">1440\u003C/span>, \u003Cspan class=\"hljs-attr\">right\u003C/span>: \u003Cspan class=\"hljs-number\">1440\u003C/span>, \u003Cspan class=\"hljs-attr\">bottom\u003C/span>: \u003Cspan class=\"hljs-number\">1440\u003C/span>, \u003Cspan class=\"hljs-attr\">left\u003C/span>: \u003Cspan class=\"hljs-number\">1440\u003C/span> } \u003Cspan class=\"hljs-comment\">// 1 inch margins\u003C/span>\n    }\n  },\n  \u003Cspan class=\"hljs-attr\">children\u003C/span>: [\u003Cspan class=\"hljs-comment\">/* content */\u003C/span>]\n}]\u003C/code>\u003C/pre>\u003C/div>\u003Cp>\u003Cstrong>Common page sizes (DXA units, 1440 DXA = 1 inch):\u003C/strong>\u003C/p>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Paper\u003C/th>\n\u003Cth>Width\u003C/th>\n\u003Cth>Height\u003C/th>\n\u003Cth>Content Width (1" margins)\u003C/th>\n\u003C/tr>\n\u003C/thead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>US Letter\u003C/td>\n\u003Ctd>12,240\u003C/td>\n\u003Ctd>15,840\u003C/td>\n\u003Ctd>9,360\u003C/td>\n\u003C/tr>\n\u003Ctr>\n\u003Ctd>A4 (default)\u003C/td>\n\u003Ctd>11,906\u003C/td>\n\u003Ctd>16,838\u003C/td>\n\u003Ctd>9,026\u003C/td>\n\u003C/tr>\n\u003C/tbody>\u003C/table>\n\u003Cp>\u003Cstrong>Landscape orientation:\u003C/strong> docx-js swaps width/height internally, so pass portrait dimensions and let it handle the swap:\u003C/p>\n\u003Cdiv class=\"md-code-block\">\u003Cdiv class=\"md-code-lang\">javascript\u003C/div>\u003Cpre>\u003Ccode class=\"hljs language-javascript\">\u003Cspan class=\"hljs-attr\">size\u003C/span>: {\n  \u003Cspan class=\"hljs-attr\">width\u003C/span>: \u003Cspan class=\"hljs-number\">12240\u003C/span>,   \u003Cspan class=\"hljs-comment\">// Pass SHORT edge as width\u003C/span>\n  \u003Cspan class=\"hljs-attr\">height\u003C/span>: \u003Cspan class=\"hljs-number\">15840\u003C/span>,  \u003Cspan class=\"hljs-comment\">// Pass LONG edge as height\u003C/span>\n  \u003Cspan class=\"hljs-attr\">orientation\u003C/span>: \u003Cspan class=\"hljs-title class_\">PageOrientation\u003C/span>.\u003Cspan class=\"hljs-property\">LANDSCAPE\u003C/span>  \u003Cspan class=\"hljs-comment\">// docx-js swaps them in the XML\u003C/span>\n},\n\u003Cspan class=\"hljs-comment\">// Content width = 15840 - left margin - right margin (uses the long edge)\u003C/span>\u003C/code>\u003C/pre>\u003C/div>\u003Ch3>Styles (Override Built-in Headings)\u003C/h3>\n\u003Cp>Use Arial as the default font (universally supported). Keep titles black for readability.\u003C/p>\n\u003Cdiv class=\"md-code-block\">\u003Cdiv class=\"md-code-lang\">javascript\u003C/div>\u003Cpre>\u003Ccode class=\"hljs language-javascript\">\u003Cspan class=\"hljs-keyword\">const\u003C/span> doc = \u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">Document\u003C/span>({\n  \u003Cspan class=\"hljs-attr\">styles\u003C/span>: {\n    \u003Cspan class=\"hljs-attr\">default\u003C/span>: { \u003Cspan class=\"hljs-attr\">document\u003C/span>: { \u003Cspan class=\"hljs-attr\">run\u003C/span>: { \u003Cspan class=\"hljs-attr\">font\u003C/span>: \u003Cspan class=\"hljs-string\">"Arial"\u003C/span>, \u003Cspan class=\"hljs-attr\">size\u003C/span>: \u003Cspan class=\"hljs-number\">24\u003C/span> } } }, \u003Cspan class=\"hljs-comment\">// 12pt default\u003C/span>\n    \u003Cspan class=\"hljs-attr\">paragraphStyles\u003C/span>: [\n      \u003Cspan class=\"hljs-comment\">// IMPORTANT: Use exact IDs to override built-in styles\u003C/span>\n      { \u003Cspan class=\"hljs-attr\">id\u003C/span>: \u003Cspan class=\"hljs-string\">"Heading1"\u003C/span>, \u003Cspan class=\"hljs-attr\">name\u003C/span>: \u003Cspan class=\"hljs-string\">"Heading 1"\u003C/span>, \u003Cspan class=\"hljs-attr\">basedOn\u003C/span>: \u003Cspan class=\"hljs-string\">"Normal"\u003C/span>, \u003Cspan class=\"hljs-attr\">next\u003C/span>: \u003Cspan class=\"hljs-string\">"Normal"\u003C/span>, \u003Cspan class=\"hljs-attr\">quickFormat\u003C/span>: \u003Cspan class=\"hljs-literal\">true\u003C/span>,\n        \u003Cspan class=\"hljs-attr\">run\u003C/span>: { \u003Cspan class=\"hljs-attr\">size\u003C/span>: \u003Cspan class=\"hljs-number\">32\u003C/span>, \u003Cspan class=\"hljs-attr\">bold\u003C/span>: \u003Cspan class=\"hljs-literal\">true\u003C/span>, \u003Cspan class=\"hljs-attr\">font\u003C/span>: \u003Cspan class=\"hljs-string\">"Arial"\u003C/span> },\n        \u003Cspan class=\"hljs-attr\">paragraph\u003C/span>: { \u003Cspan class=\"hljs-attr\">spacing\u003C/span>: { \u003Cspan class=\"hljs-attr\">before\u003C/span>: \u003Cspan class=\"hljs-number\">240\u003C/span>, \u003Cspan class=\"hljs-attr\">after\u003C/span>: \u003Cspan class=\"hljs-number\">240\u003C/span> }, \u003Cspan class=\"hljs-attr\">outlineLevel\u003C/span>: \u003Cspan class=\"hljs-number\">0\u003C/span> } }, \u003Cspan class=\"hljs-comment\">// outlineLevel required for TOC\u003C/span>\n      { \u003Cspan class=\"hljs-attr\">id\u003C/span>: \u003Cspan class=\"hljs-string\">"Heading2"\u003C/span>, \u003Cspan class=\"hljs-attr\">name\u003C/span>: \u003Cspan class=\"hljs-string\">"Heading 2"\u003C/span>, \u003Cspan class=\"hljs-attr\">basedOn\u003C/span>: \u003Cspan class=\"hljs-string\">"Normal"\u003C/span>, \u003Cspan class=\"hljs-attr\">next\u003C/span>: \u003Cspan class=\"hljs-string\">"Normal"\u003C/span>, \u003Cspan class=\"hljs-attr\">quickFormat\u003C/span>: \u003Cspan class=\"hljs-literal\">true\u003C/span>,\n        \u003Cspan class=\"hljs-attr\">run\u003C/span>: { \u003Cspan class=\"hljs-attr\">size\u003C/span>: \u003Cspan class=\"hljs-number\">28\u003C/span>, \u003Cspan class=\"hljs-attr\">bold\u003C/span>: \u003Cspan class=\"hljs-literal\">true\u003C/span>, \u003Cspan class=\"hljs-attr\">font\u003C/span>: \u003Cspan class=\"hljs-string\">"Arial"\u003C/span> },\n        \u003Cspan class=\"hljs-attr\">paragraph\u003C/span>: { \u003Cspan class=\"hljs-attr\">spacing\u003C/span>: { \u003Cspan class=\"hljs-attr\">before\u003C/span>: \u003Cspan class=\"hljs-number\">180\u003C/span>, \u003Cspan class=\"hljs-attr\">after\u003C/span>: \u003Cspan class=\"hljs-number\">180\u003C/span> }, \u003Cspan class=\"hljs-attr\">outlineLevel\u003C/span>: \u003Cspan class=\"hljs-number\">1\u003C/span> } },\n    ]\n  },\n  \u003Cspan class=\"hljs-attr\">sections\u003C/span>: [{\n    \u003Cspan class=\"hljs-attr\">children\u003C/span>: [\n      \u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">Paragraph\u003C/span>({ \u003Cspan class=\"hljs-attr\">heading\u003C/span>: \u003Cspan class=\"hljs-title class_\">HeadingLevel\u003C/span>.\u003Cspan class=\"hljs-property\">HEADING_1\u003C/span>, \u003Cspan class=\"hljs-attr\">children\u003C/span>: [\u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">TextRun\u003C/span>(\u003Cspan class=\"hljs-string\">"Title"\u003C/span>)] }),\n    ]\n  }]\n});\u003C/code>\u003C/pre>\u003C/div>\u003Ch3>Lists (NEVER use unicode bullets)\u003C/h3>\n\u003Cdiv class=\"md-code-block\">\u003Cdiv class=\"md-code-lang\">javascript\u003C/div>\u003Cpre>\u003Ccode class=\"hljs language-javascript\">\u003Cspan class=\"hljs-comment\">// ❌ WRONG - never manually insert bullet characters\u003C/span>\n\u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">Paragraph\u003C/span>({ \u003Cspan class=\"hljs-attr\">children\u003C/span>: [\u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">TextRun\u003C/span>(\u003Cspan class=\"hljs-string\">"• Item"\u003C/span>)] })  \u003Cspan class=\"hljs-comment\">// BAD\u003C/span>\n\u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">Paragraph\u003C/span>({ \u003Cspan class=\"hljs-attr\">children\u003C/span>: [\u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">TextRun\u003C/span>(\u003Cspan class=\"hljs-string\">"\\u2022 Item"\u003C/span>)] })  \u003Cspan class=\"hljs-comment\">// BAD\u003C/span>\n\n\u003Cspan class=\"hljs-comment\">// ✅ CORRECT - use numbering config with LevelFormat.BULLET\u003C/span>\n\u003Cspan class=\"hljs-keyword\">const\u003C/span> doc = \u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">Document\u003C/span>({\n  \u003Cspan class=\"hljs-attr\">numbering\u003C/span>: {\n    \u003Cspan class=\"hljs-attr\">config\u003C/span>: [\n      { \u003Cspan class=\"hljs-attr\">reference\u003C/span>: \u003Cspan class=\"hljs-string\">"bullets"\u003C/span>,\n        \u003Cspan class=\"hljs-attr\">levels\u003C/span>: [{ \u003Cspan class=\"hljs-attr\">level\u003C/span>: \u003Cspan class=\"hljs-number\">0\u003C/span>, \u003Cspan class=\"hljs-attr\">format\u003C/span>: \u003Cspan class=\"hljs-title class_\">LevelFormat\u003C/span>.\u003Cspan class=\"hljs-property\">BULLET\u003C/span>, \u003Cspan class=\"hljs-attr\">text\u003C/span>: \u003Cspan class=\"hljs-string\">"•"\u003C/span>, \u003Cspan class=\"hljs-attr\">alignment\u003C/span>: \u003Cspan class=\"hljs-title class_\">AlignmentType\u003C/span>.\u003Cspan class=\"hljs-property\">LEFT\u003C/span>,\n          \u003Cspan class=\"hljs-attr\">style\u003C/span>: { \u003Cspan class=\"hljs-attr\">paragraph\u003C/span>: { \u003Cspan class=\"hljs-attr\">indent\u003C/span>: { \u003Cspan class=\"hljs-attr\">left\u003C/span>: \u003Cspan class=\"hljs-number\">720\u003C/span>, \u003Cspan class=\"hljs-attr\">hanging\u003C/span>: \u003Cspan class=\"hljs-number\">360\u003C/span> } } } }] },\n      { \u003Cspan class=\"hljs-attr\">reference\u003C/span>: \u003Cspan class=\"hljs-string\">"numbers"\u003C/span>,\n        \u003Cspan class=\"hljs-attr\">levels\u003C/span>: [{ \u003Cspan class=\"hljs-attr\">level\u003C/span>: \u003Cspan class=\"hljs-number\">0\u003C/span>, \u003Cspan class=\"hljs-attr\">format\u003C/span>: \u003Cspan class=\"hljs-title class_\">LevelFormat\u003C/span>.\u003Cspan class=\"hljs-property\">DECIMAL\u003C/span>, \u003Cspan class=\"hljs-attr\">text\u003C/span>: \u003Cspan class=\"hljs-string\">"%1."\u003C/span>, \u003Cspan class=\"hljs-attr\">alignment\u003C/span>: \u003Cspan class=\"hljs-title class_\">AlignmentType\u003C/span>.\u003Cspan class=\"hljs-property\">LEFT\u003C/span>,\n          \u003Cspan class=\"hljs-attr\">style\u003C/span>: { \u003Cspan class=\"hljs-attr\">paragraph\u003C/span>: { \u003Cspan class=\"hljs-attr\">indent\u003C/span>: { \u003Cspan class=\"hljs-attr\">left\u003C/span>: \u003Cspan class=\"hljs-number\">720\u003C/span>, \u003Cspan class=\"hljs-attr\">hanging\u003C/span>: \u003Cspan class=\"hljs-number\">360\u003C/span> } } } }] },\n    ]\n  },\n  \u003Cspan class=\"hljs-attr\">sections\u003C/span>: [{\n    \u003Cspan class=\"hljs-attr\">children\u003C/span>: [\n      \u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">Paragraph\u003C/span>({ \u003Cspan class=\"hljs-attr\">numbering\u003C/span>: { \u003Cspan class=\"hljs-attr\">reference\u003C/span>: \u003Cspan class=\"hljs-string\">"bullets"\u003C/span>, \u003Cspan class=\"hljs-attr\">level\u003C/span>: \u003Cspan class=\"hljs-number\">0\u003C/span> },\n        \u003Cspan class=\"hljs-attr\">children\u003C/span>: [\u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">TextRun\u003C/span>(\u003Cspan class=\"hljs-string\">"Bullet item"\u003C/span>)] }),\n      \u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">Paragraph\u003C/span>({ \u003Cspan class=\"hljs-attr\">numbering\u003C/span>: { \u003Cspan class=\"hljs-attr\">reference\u003C/span>: \u003Cspan class=\"hljs-string\">"numbers"\u003C/span>, \u003Cspan class=\"hljs-attr\">level\u003C/span>: \u003Cspan class=\"hljs-number\">0\u003C/span> },\n        \u003Cspan class=\"hljs-attr\">children\u003C/span>: [\u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">TextRun\u003C/span>(\u003Cspan class=\"hljs-string\">"Numbered item"\u003C/span>)] }),\n    ]\n  }]\n});\n\n\u003Cspan class=\"hljs-comment\">// ⚠️ Each reference creates INDEPENDENT numbering\u003C/span>\n\u003Cspan class=\"hljs-comment\">// Same reference = continues (1,2,3 then 4,5,6)\u003C/span>\n\u003Cspan class=\"hljs-comment\">// Different reference = restarts (1,2,3 then 1,2,3)\u003C/span>\u003C/code>\u003C/pre>\u003C/div>\u003Ch3>Tables\u003C/h3>\n\u003Cp>\u003Cstrong>CRITICAL: Tables need dual widths\u003C/strong> - set both \u003Ccode>columnWidths\u003C/code> on the table AND \u003Ccode>width\u003C/code> on each cell. Without both, tables render incorrectly on some platforms.\u003C/p>\n\u003Cdiv class=\"md-code-block\">\u003Cdiv class=\"md-code-lang\">javascript\u003C/div>\u003Cpre>\u003Ccode class=\"hljs language-javascript\">\u003Cspan class=\"hljs-comment\">// CRITICAL: Always set table width for consistent rendering\u003C/span>\n\u003Cspan class=\"hljs-comment\">// CRITICAL: Use ShadingType.CLEAR (not SOLID) to prevent black backgrounds\u003C/span>\n\u003Cspan class=\"hljs-keyword\">const\u003C/span> border = { \u003Cspan class=\"hljs-attr\">style\u003C/span>: \u003Cspan class=\"hljs-title class_\">BorderStyle\u003C/span>.\u003Cspan class=\"hljs-property\">SINGLE\u003C/span>, \u003Cspan class=\"hljs-attr\">size\u003C/span>: \u003Cspan class=\"hljs-number\">1\u003C/span>, \u003Cspan class=\"hljs-attr\">color\u003C/span>: \u003Cspan class=\"hljs-string\">"CCCCCC"\u003C/span> };\n\u003Cspan class=\"hljs-keyword\">const\u003C/span> borders = { \u003Cspan class=\"hljs-attr\">top\u003C/span>: border, \u003Cspan class=\"hljs-attr\">bottom\u003C/span>: border, \u003Cspan class=\"hljs-attr\">left\u003C/span>: border, \u003Cspan class=\"hljs-attr\">right\u003C/span>: border };\n\n\u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">Table\u003C/span>({\n  \u003Cspan class=\"hljs-attr\">width\u003C/span>: { \u003Cspan class=\"hljs-attr\">size\u003C/span>: \u003Cspan class=\"hljs-number\">9360\u003C/span>, \u003Cspan class=\"hljs-attr\">type\u003C/span>: \u003Cspan class=\"hljs-title class_\">WidthType\u003C/span>.\u003Cspan class=\"hljs-property\">DXA\u003C/span> }, \u003Cspan class=\"hljs-comment\">// Always use DXA (percentages break in Google Docs)\u003C/span>\n  \u003Cspan class=\"hljs-attr\">columnWidths\u003C/span>: [\u003Cspan class=\"hljs-number\">4680\u003C/span>, \u003Cspan class=\"hljs-number\">4680\u003C/span>], \u003Cspan class=\"hljs-comment\">// Must sum to table width (DXA: 1440 = 1 inch)\u003C/span>\n  \u003Cspan class=\"hljs-attr\">rows\u003C/span>: [\n    \u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">TableRow\u003C/span>({\n      \u003Cspan class=\"hljs-attr\">children\u003C/span>: [\n        \u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">TableCell\u003C/span>({\n          borders,\n          \u003Cspan class=\"hljs-attr\">width\u003C/span>: { \u003Cspan class=\"hljs-attr\">size\u003C/span>: \u003Cspan class=\"hljs-number\">4680\u003C/span>, \u003Cspan class=\"hljs-attr\">type\u003C/span>: \u003Cspan class=\"hljs-title class_\">WidthType\u003C/span>.\u003Cspan class=\"hljs-property\">DXA\u003C/span> }, \u003Cspan class=\"hljs-comment\">// Also set on each cell\u003C/span>\n          \u003Cspan class=\"hljs-attr\">shading\u003C/span>: { \u003Cspan class=\"hljs-attr\">fill\u003C/span>: \u003Cspan class=\"hljs-string\">"D5E8F0"\u003C/span>, \u003Cspan class=\"hljs-attr\">type\u003C/span>: \u003Cspan class=\"hljs-title class_\">ShadingType\u003C/span>.\u003Cspan class=\"hljs-property\">CLEAR\u003C/span> }, \u003Cspan class=\"hljs-comment\">// CLEAR not SOLID\u003C/span>\n          \u003Cspan class=\"hljs-attr\">margins\u003C/span>: { \u003Cspan class=\"hljs-attr\">top\u003C/span>: \u003Cspan class=\"hljs-number\">80\u003C/span>, \u003Cspan class=\"hljs-attr\">bottom\u003C/span>: \u003Cspan class=\"hljs-number\">80\u003C/span>, \u003Cspan class=\"hljs-attr\">left\u003C/span>: \u003Cspan class=\"hljs-number\">120\u003C/span>, \u003Cspan class=\"hljs-attr\">right\u003C/span>: \u003Cspan class=\"hljs-number\">120\u003C/span> }, \u003Cspan class=\"hljs-comment\">// Cell padding (internal, not added to width)\u003C/span>\n          \u003Cspan class=\"hljs-attr\">children\u003C/span>: [\u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">Paragraph\u003C/span>({ \u003Cspan class=\"hljs-attr\">children\u003C/span>: [\u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">TextRun\u003C/span>(\u003Cspan class=\"hljs-string\">"Cell"\u003C/span>)] })]\n        })\n      ]\n    })\n  ]\n})\u003C/code>\u003C/pre>\u003C/div>\u003Cp>\u003Cstrong>Table width calculation:\u003C/strong>\u003C/p>\n\u003Cp>Always use \u003Ccode>WidthType.DXA\u003C/code> — \u003Ccode>WidthType.PERCENTAGE\u003C/code> breaks in Google Docs.\u003C/p>\n\u003Cdiv class=\"md-code-block\">\u003Cdiv class=\"md-code-lang\">javascript\u003C/div>\u003Cpre>\u003Ccode class=\"hljs language-javascript\">\u003Cspan class=\"hljs-comment\">// Table width = sum of columnWidths = content width\u003C/span>\n\u003Cspan class=\"hljs-comment\">// US Letter with 1" margins: 12240 - 2880 = 9360 DXA\u003C/span>\n\u003Cspan class=\"hljs-attr\">width\u003C/span>: { \u003Cspan class=\"hljs-attr\">size\u003C/span>: \u003Cspan class=\"hljs-number\">9360\u003C/span>, \u003Cspan class=\"hljs-attr\">type\u003C/span>: \u003Cspan class=\"hljs-title class_\">WidthType\u003C/span>.\u003Cspan class=\"hljs-property\">DXA\u003C/span> },\n\u003Cspan class=\"hljs-attr\">columnWidths\u003C/span>: [\u003Cspan class=\"hljs-number\">7000\u003C/span>, \u003Cspan class=\"hljs-number\">2360\u003C/span>]  \u003Cspan class=\"hljs-comment\">// Must sum to table width\u003C/span>\u003C/code>\u003C/pre>\u003C/div>\u003Cp>\u003Cstrong>Width rules:\u003C/strong>\u003C/p>\n\u003Cul>\n\u003Cli>\u003Cstrong>Always use \u003Ccode>WidthType.DXA\u003C/code>\u003C/strong> — never \u003Ccode>WidthType.PERCENTAGE\u003C/code> (incompatible with Google Docs)\u003C/li>\n\u003Cli>Table width must equal the sum of \u003Ccode>columnWidths\u003C/code>\u003C/li>\n\u003Cli>Cell \u003Ccode>width\u003C/code> must match corresponding \u003Ccode>columnWidth\u003C/code>\u003C/li>\n\u003Cli>Cell \u003Ccode>margins\u003C/code> are internal padding - they reduce content area, not add to cell width\u003C/li>\n\u003Cli>For full-width tables: use content width (page width minus left and right margins)\u003C/li>\n\u003C/ul>\n\u003Ch3>Images\u003C/h3>\n\u003Cdiv class=\"md-code-block\">\u003Cdiv class=\"md-code-lang\">javascript\u003C/div>\u003Cpre>\u003Ccode class=\"hljs language-javascript\">\u003Cspan class=\"hljs-comment\">// CRITICAL: type parameter is REQUIRED\u003C/span>\n\u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">Paragraph\u003C/span>({\n  \u003Cspan class=\"hljs-attr\">children\u003C/span>: [\u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">ImageRun\u003C/span>({\n    \u003Cspan class=\"hljs-attr\">type\u003C/span>: \u003Cspan class=\"hljs-string\">"png"\u003C/span>, \u003Cspan class=\"hljs-comment\">// Required: png, jpg, jpeg, gif, bmp, svg\u003C/span>\n    \u003Cspan class=\"hljs-attr\">data\u003C/span>: fs.\u003Cspan class=\"hljs-title function_\">readFileSync\u003C/span>(\u003Cspan class=\"hljs-string\">"image.png"\u003C/span>),\n    \u003Cspan class=\"hljs-attr\">transformation\u003C/span>: { \u003Cspan class=\"hljs-attr\">width\u003C/span>: \u003Cspan class=\"hljs-number\">200\u003C/span>, \u003Cspan class=\"hljs-attr\">height\u003C/span>: \u003Cspan class=\"hljs-number\">150\u003C/span> },\n    \u003Cspan class=\"hljs-attr\">altText\u003C/span>: { \u003Cspan class=\"hljs-attr\">title\u003C/span>: \u003Cspan class=\"hljs-string\">"Title"\u003C/span>, \u003Cspan class=\"hljs-attr\">description\u003C/span>: \u003Cspan class=\"hljs-string\">"Desc"\u003C/span>, \u003Cspan class=\"hljs-attr\">name\u003C/span>: \u003Cspan class=\"hljs-string\">"Name"\u003C/span> } \u003Cspan class=\"hljs-comment\">// All three required\u003C/span>\n  })]\n})\u003C/code>\u003C/pre>\u003C/div>\u003Ch3>Page Breaks\u003C/h3>\n\u003Cdiv class=\"md-code-block\">\u003Cdiv class=\"md-code-lang\">javascript\u003C/div>\u003Cpre>\u003Ccode class=\"hljs language-javascript\">\u003Cspan class=\"hljs-comment\">// CRITICAL: PageBreak must be inside a Paragraph\u003C/span>\n\u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">Paragraph\u003C/span>({ \u003Cspan class=\"hljs-attr\">children\u003C/span>: [\u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">PageBreak\u003C/span>()] })\n\n\u003Cspan class=\"hljs-comment\">// Or use pageBreakBefore\u003C/span>\n\u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">Paragraph\u003C/span>({ \u003Cspan class=\"hljs-attr\">pageBreakBefore\u003C/span>: \u003Cspan class=\"hljs-literal\">true\u003C/span>, \u003Cspan class=\"hljs-attr\">children\u003C/span>: [\u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">TextRun\u003C/span>(\u003Cspan class=\"hljs-string\">"New page"\u003C/span>)] })\u003C/code>\u003C/pre>\u003C/div>\u003Ch3>Hyperlinks\u003C/h3>\n\u003Cdiv class=\"md-code-block\">\u003Cdiv class=\"md-code-lang\">javascript\u003C/div>\u003Cpre>\u003Ccode class=\"hljs language-javascript\">\u003Cspan class=\"hljs-comment\">// External link\u003C/span>\n\u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">Paragraph\u003C/span>({\n  \u003Cspan class=\"hljs-attr\">children\u003C/span>: [\u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">ExternalHyperlink\u003C/span>({\n    \u003Cspan class=\"hljs-attr\">children\u003C/span>: [\u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">TextRun\u003C/span>({ \u003Cspan class=\"hljs-attr\">text\u003C/span>: \u003Cspan class=\"hljs-string\">"Click here"\u003C/span>, \u003Cspan class=\"hljs-attr\">style\u003C/span>: \u003Cspan class=\"hljs-string\">"Hyperlink"\u003C/span> })],\n    \u003Cspan class=\"hljs-attr\">link\u003C/span>: \u003Cspan class=\"hljs-string\">"https://example.com"\u003C/span>,\n  })]\n})\n\n\u003Cspan class=\"hljs-comment\">// Internal link (bookmark + reference)\u003C/span>\n\u003Cspan class=\"hljs-comment\">// 1. Create bookmark at destination\u003C/span>\n\u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">Paragraph\u003C/span>({ \u003Cspan class=\"hljs-attr\">heading\u003C/span>: \u003Cspan class=\"hljs-title class_\">HeadingLevel\u003C/span>.\u003Cspan class=\"hljs-property\">HEADING_1\u003C/span>, \u003Cspan class=\"hljs-attr\">children\u003C/span>: [\n  \u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">Bookmark\u003C/span>({ \u003Cspan class=\"hljs-attr\">id\u003C/span>: \u003Cspan class=\"hljs-string\">"chapter1"\u003C/span>, \u003Cspan class=\"hljs-attr\">children\u003C/span>: [\u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">TextRun\u003C/span>(\u003Cspan class=\"hljs-string\">"Chapter 1"\u003C/span>)] }),\n]})\n\u003Cspan class=\"hljs-comment\">// 2. Link to it\u003C/span>\n\u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">Paragraph\u003C/span>({ \u003Cspan class=\"hljs-attr\">children\u003C/span>: [\u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">InternalHyperlink\u003C/span>({\n  \u003Cspan class=\"hljs-attr\">children\u003C/span>: [\u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">TextRun\u003C/span>({ \u003Cspan class=\"hljs-attr\">text\u003C/span>: \u003Cspan class=\"hljs-string\">"See Chapter 1"\u003C/span>, \u003Cspan class=\"hljs-attr\">style\u003C/span>: \u003Cspan class=\"hljs-string\">"Hyperlink"\u003C/span> })],\n  \u003Cspan class=\"hljs-attr\">anchor\u003C/span>: \u003Cspan class=\"hljs-string\">"chapter1"\u003C/span>,\n})]})\u003C/code>\u003C/pre>\u003C/div>\u003Ch3>Footnotes\u003C/h3>\n\u003Cdiv class=\"md-code-block\">\u003Cdiv class=\"md-code-lang\">javascript\u003C/div>\u003Cpre>\u003Ccode class=\"hljs language-javascript\">\u003Cspan class=\"hljs-keyword\">const\u003C/span> doc = \u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">Document\u003C/span>({\n  \u003Cspan class=\"hljs-attr\">footnotes\u003C/span>: {\n    \u003Cspan class=\"hljs-number\">1\u003C/span>: { \u003Cspan class=\"hljs-attr\">children\u003C/span>: [\u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">Paragraph\u003C/span>(\u003Cspan class=\"hljs-string\">"Source: Annual Report 2024"\u003C/span>)] },\n    \u003Cspan class=\"hljs-number\">2\u003C/span>: { \u003Cspan class=\"hljs-attr\">children\u003C/span>: [\u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">Paragraph\u003C/span>(\u003Cspan class=\"hljs-string\">"See appendix for methodology"\u003C/span>)] },\n  },\n  \u003Cspan class=\"hljs-attr\">sections\u003C/span>: [{\n    \u003Cspan class=\"hljs-attr\">children\u003C/span>: [\u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">Paragraph\u003C/span>({\n      \u003Cspan class=\"hljs-attr\">children\u003C/span>: [\n        \u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">TextRun\u003C/span>(\u003Cspan class=\"hljs-string\">"Revenue grew 15%"\u003C/span>),\n        \u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">FootnoteReferenceRun\u003C/span>(\u003Cspan class=\"hljs-number\">1\u003C/span>),\n        \u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">TextRun\u003C/span>(\u003Cspan class=\"hljs-string\">" using adjusted metrics"\u003C/span>),\n        \u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">FootnoteReferenceRun\u003C/span>(\u003Cspan class=\"hljs-number\">2\u003C/span>),\n      ],\n    })]\n  }]\n});\u003C/code>\u003C/pre>\u003C/div>\u003Ch3>Tab Stops\u003C/h3>\n\u003Cdiv class=\"md-code-block\">\u003Cdiv class=\"md-code-lang\">javascript\u003C/div>\u003Cpre>\u003Ccode class=\"hljs language-javascript\">\u003Cspan class=\"hljs-comment\">// Right-align text on same line (e.g., date opposite a title)\u003C/span>\n\u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">Paragraph\u003C/span>({\n  \u003Cspan class=\"hljs-attr\">children\u003C/span>: [\n    \u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">TextRun\u003C/span>(\u003Cspan class=\"hljs-string\">"Company Name"\u003C/span>),\n    \u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">TextRun\u003C/span>(\u003Cspan class=\"hljs-string\">"\\tJanuary 2025"\u003C/span>),\n  ],\n  \u003Cspan class=\"hljs-attr\">tabStops\u003C/span>: [{ \u003Cspan class=\"hljs-attr\">type\u003C/span>: \u003Cspan class=\"hljs-title class_\">TabStopType\u003C/span>.\u003Cspan class=\"hljs-property\">RIGHT\u003C/span>, \u003Cspan class=\"hljs-attr\">position\u003C/span>: \u003Cspan class=\"hljs-title class_\">TabStopPosition\u003C/span>.\u003Cspan class=\"hljs-property\">MAX\u003C/span> }],\n})\n\n\u003Cspan class=\"hljs-comment\">// Dot leader (e.g., TOC-style)\u003C/span>\n\u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">Paragraph\u003C/span>({\n  \u003Cspan class=\"hljs-attr\">children\u003C/span>: [\n    \u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">TextRun\u003C/span>(\u003Cspan class=\"hljs-string\">"Introduction"\u003C/span>),\n    \u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">TextRun\u003C/span>({ \u003Cspan class=\"hljs-attr\">children\u003C/span>: [\n      \u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">PositionalTab\u003C/span>({\n        \u003Cspan class=\"hljs-attr\">alignment\u003C/span>: \u003Cspan class=\"hljs-title class_\">PositionalTabAlignment\u003C/span>.\u003Cspan class=\"hljs-property\">RIGHT\u003C/span>,\n        \u003Cspan class=\"hljs-attr\">relativeTo\u003C/span>: \u003Cspan class=\"hljs-title class_\">PositionalTabRelativeTo\u003C/span>.\u003Cspan class=\"hljs-property\">MARGIN\u003C/span>,\n        \u003Cspan class=\"hljs-attr\">leader\u003C/span>: \u003Cspan class=\"hljs-title class_\">PositionalTabLeader\u003C/span>.\u003Cspan class=\"hljs-property\">DOT\u003C/span>,\n      }),\n      \u003Cspan class=\"hljs-string\">"3"\u003C/span>,\n    ]}),\n  ],\n})\u003C/code>\u003C/pre>\u003C/div>\u003Ch3>Multi-Column Layouts\u003C/h3>\n\u003Cdiv class=\"md-code-block\">\u003Cdiv class=\"md-code-lang\">javascript\u003C/div>\u003Cpre>\u003Ccode class=\"hljs language-javascript\">\u003Cspan class=\"hljs-comment\">// Equal-width columns\u003C/span>\n\u003Cspan class=\"hljs-attr\">sections\u003C/span>: [{\n  \u003Cspan class=\"hljs-attr\">properties\u003C/span>: {\n    \u003Cspan class=\"hljs-attr\">column\u003C/span>: {\n      \u003Cspan class=\"hljs-attr\">count\u003C/span>: \u003Cspan class=\"hljs-number\">2\u003C/span>,          \u003Cspan class=\"hljs-comment\">// number of columns\u003C/span>\n      \u003Cspan class=\"hljs-attr\">space\u003C/span>: \u003Cspan class=\"hljs-number\">720\u003C/span>,        \u003Cspan class=\"hljs-comment\">// gap between columns in DXA (720 = 0.5 inch)\u003C/span>\n      \u003Cspan class=\"hljs-attr\">equalWidth\u003C/span>: \u003Cspan class=\"hljs-literal\">true\u003C/span>,\n      \u003Cspan class=\"hljs-attr\">separate\u003C/span>: \u003Cspan class=\"hljs-literal\">true\u003C/span>,    \u003Cspan class=\"hljs-comment\">// vertical line between columns\u003C/span>\n    },\n  },\n  \u003Cspan class=\"hljs-attr\">children\u003C/span>: [\u003Cspan class=\"hljs-comment\">/* content flows naturally across columns */\u003C/span>]\n}]\n\n\u003Cspan class=\"hljs-comment\">// Custom-width columns (equalWidth must be false)\u003C/span>\n\u003Cspan class=\"hljs-attr\">sections\u003C/span>: [{\n  \u003Cspan class=\"hljs-attr\">properties\u003C/span>: {\n    \u003Cspan class=\"hljs-attr\">column\u003C/span>: {\n      \u003Cspan class=\"hljs-attr\">equalWidth\u003C/span>: \u003Cspan class=\"hljs-literal\">false\u003C/span>,\n      \u003Cspan class=\"hljs-attr\">children\u003C/span>: [\n        \u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">Column\u003C/span>({ \u003Cspan class=\"hljs-attr\">width\u003C/span>: \u003Cspan class=\"hljs-number\">5400\u003C/span>, \u003Cspan class=\"hljs-attr\">space\u003C/span>: \u003Cspan class=\"hljs-number\">720\u003C/span> }),\n        \u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">Column\u003C/span>({ \u003Cspan class=\"hljs-attr\">width\u003C/span>: \u003Cspan class=\"hljs-number\">3240\u003C/span> }),\n      ],\n    },\n  },\n  \u003Cspan class=\"hljs-attr\">children\u003C/span>: [\u003Cspan class=\"hljs-comment\">/* content */\u003C/span>]\n}]\u003C/code>\u003C/pre>\u003C/div>\u003Cp>Force a column break with a new section using \u003Ccode>type: SectionType.NEXT_COLUMN\u003C/code>.\u003C/p>\n\u003Ch3>Table of Contents\u003C/h3>\n\u003Cdiv class=\"md-code-block\">\u003Cdiv class=\"md-code-lang\">javascript\u003C/div>\u003Cpre>\u003Ccode class=\"hljs language-javascript\">\u003Cspan class=\"hljs-comment\">// CRITICAL: Headings must use HeadingLevel ONLY - no custom styles\u003C/span>\n\u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">TableOfContents\u003C/span>(\u003Cspan class=\"hljs-string\">"Table of Contents"\u003C/span>, { \u003Cspan class=\"hljs-attr\">hyperlink\u003C/span>: \u003Cspan class=\"hljs-literal\">true\u003C/span>, \u003Cspan class=\"hljs-attr\">headingStyleRange\u003C/span>: \u003Cspan class=\"hljs-string\">"1-3"\u003C/span> })\u003C/code>\u003C/pre>\u003C/div>\u003Ch3>Headers/Footers\u003C/h3>\n\u003Cdiv class=\"md-code-block\">\u003Cdiv class=\"md-code-lang\">javascript\u003C/div>\u003Cpre>\u003Ccode class=\"hljs language-javascript\">\u003Cspan class=\"hljs-attr\">sections\u003C/span>: [{\n  \u003Cspan class=\"hljs-attr\">properties\u003C/span>: {\n    \u003Cspan class=\"hljs-attr\">page\u003C/span>: { \u003Cspan class=\"hljs-attr\">margin\u003C/span>: { \u003Cspan class=\"hljs-attr\">top\u003C/span>: \u003Cspan class=\"hljs-number\">1440\u003C/span>, \u003Cspan class=\"hljs-attr\">right\u003C/span>: \u003Cspan class=\"hljs-number\">1440\u003C/span>, \u003Cspan class=\"hljs-attr\">bottom\u003C/span>: \u003Cspan class=\"hljs-number\">1440\u003C/span>, \u003Cspan class=\"hljs-attr\">left\u003C/span>: \u003Cspan class=\"hljs-number\">1440\u003C/span> } } \u003Cspan class=\"hljs-comment\">// 1440 = 1 inch\u003C/span>\n  },\n  \u003Cspan class=\"hljs-attr\">headers\u003C/span>: {\n    \u003Cspan class=\"hljs-attr\">default\u003C/span>: \u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">Header\u003C/span>({ \u003Cspan class=\"hljs-attr\">children\u003C/span>: [\u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">Paragraph\u003C/span>({ \u003Cspan class=\"hljs-attr\">children\u003C/span>: [\u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">TextRun\u003C/span>(\u003Cspan class=\"hljs-string\">"Header"\u003C/span>)] })] })\n  },\n  \u003Cspan class=\"hljs-attr\">footers\u003C/span>: {\n    \u003Cspan class=\"hljs-attr\">default\u003C/span>: \u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">Footer\u003C/span>({ \u003Cspan class=\"hljs-attr\">children\u003C/span>: [\u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">Paragraph\u003C/span>({\n      \u003Cspan class=\"hljs-attr\">children\u003C/span>: [\u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">TextRun\u003C/span>(\u003Cspan class=\"hljs-string\">"Page "\u003C/span>), \u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">TextRun\u003C/span>({ \u003Cspan class=\"hljs-attr\">children\u003C/span>: [\u003Cspan class=\"hljs-title class_\">PageNumber\u003C/span>.\u003Cspan class=\"hljs-property\">CURRENT\u003C/span>] })]\n    })] })\n  },\n  \u003Cspan class=\"hljs-attr\">children\u003C/span>: [\u003Cspan class=\"hljs-comment\">/* content */\u003C/span>]\n}]\u003C/code>\u003C/pre>\u003C/div>\u003Ch3>Critical Rules for docx-js\u003C/h3>\n\u003Cul>\n\u003Cli>\u003Cstrong>Set page size explicitly\u003C/strong> - docx-js defaults to A4; use US Letter (12240 x 15840 DXA) for US documents\u003C/li>\n\u003Cli>\u003Cstrong>Landscape: pass portrait dimensions\u003C/strong> - docx-js swaps width/height internally; pass short edge as \u003Ccode>width\u003C/code>, long edge as \u003Ccode>height\u003C/code>, and set \u003Ccode>orientation: PageOrientation.LANDSCAPE\u003C/code>\u003C/li>\n\u003Cli>\u003Cstrong>Never use \u003Ccode>\\n\u003C/code>\u003C/strong> - use separate Paragraph elements\u003C/li>\n\u003Cli>\u003Cstrong>Never use unicode bullets\u003C/strong> - use \u003Ccode>LevelFormat.BULLET\u003C/code> with numbering config\u003C/li>\n\u003Cli>\u003Cstrong>PageBreak must be in Paragraph\u003C/strong> - standalone creates invalid XML\u003C/li>\n\u003Cli>\u003Cstrong>ImageRun requires \u003Ccode>type\u003C/code>\u003C/strong> - always specify png/jpg/etc\u003C/li>\n\u003Cli>\u003Cstrong>Always set table \u003Ccode>width\u003C/code> with DXA\u003C/strong> - never use \u003Ccode>WidthType.PERCENTAGE\u003C/code> (breaks in Google Docs)\u003C/li>\n\u003Cli>\u003Cstrong>Tables need dual widths\u003C/strong> - \u003Ccode>columnWidths\u003C/code> array AND cell \u003Ccode>width\u003C/code>, both must match\u003C/li>\n\u003Cli>\u003Cstrong>Table width = sum of columnWidths\u003C/strong> - for DXA, ensure they add up exactly\u003C/li>\n\u003Cli>\u003Cstrong>Always add cell margins\u003C/strong> - use \u003Ccode>margins: { top: 80, bottom: 80, left: 120, right: 120 }\u003C/code> for readable padding\u003C/li>\n\u003Cli>\u003Cstrong>Use \u003Ccode>ShadingType.CLEAR\u003C/code>\u003C/strong> - never SOLID for table shading\u003C/li>\n\u003Cli>\u003Cstrong>Never use tables as dividers/rules\u003C/strong> - cells have minimum height and render as empty boxes (including in headers/footers); use \u003Ccode>border: { bottom: { style: BorderStyle.SINGLE, size: 6, color: "2E75B6", space: 1 } }\u003C/code> on a Paragraph instead. For two-column footers, use tab stops (see Tab Stops section), not tables\u003C/li>\n\u003Cli>\u003Cstrong>TOC requires HeadingLevel only\u003C/strong> - no custom styles on heading paragraphs\u003C/li>\n\u003Cli>\u003Cstrong>Override built-in styles\u003C/strong> - use exact IDs: "Heading1", "Heading2", etc.\u003C/li>\n\u003Cli>\u003Cstrong>Include \u003Ccode>outlineLevel\u003C/code>\u003C/strong> - required for TOC (0 for H1, 1 for H2, etc.)\u003C/li>\n\u003C/ul>\n\u003Chr>\n\u003Ch2>Editing Existing Documents\u003C/h2>\n\u003Cp>\u003Cstrong>Follow all 3 steps in order.\u003C/strong>\u003C/p>\n\u003Ch3>Step 1: Unpack\u003C/h3>\n\u003Cdiv class=\"md-code-block\">\u003Cdiv class=\"md-code-lang\">bash\u003C/div>\u003Cpre>\u003Ccode class=\"hljs language-bash\">python scripts/office/unpack.py document.docx unpacked/\u003C/code>\u003C/pre>\u003C/div>\u003Cp>Extracts XML, pretty-prints, merges adjacent runs, and converts smart quotes to XML entities (\u003Ccode>“\u003C/code> etc.) so they survive editing. Use \u003Ccode>--merge-runs false\u003C/code> to skip run merging.\u003C/p>\n\u003Ch3>Step 2: Edit XML\u003C/h3>\n\u003Cp>Edit files in \u003Ccode>unpacked/word/\u003C/code>. See XML Reference below for patterns.\u003C/p>\n\u003Cp>\u003Cstrong>Use "Claude" as the author\u003C/strong> for tracked changes and comments, unless the user explicitly requests use of a different name.\u003C/p>\n\u003Cp>\u003Cstrong>Use the Edit tool directly for string replacement. Do not write Python scripts.\u003C/strong> Scripts introduce unnecessary complexity. The Edit tool shows exactly what is being replaced.\u003C/p>\n\u003Cp>\u003Cstrong>CRITICAL: Use smart quotes for new content.\u003C/strong> When adding text with apostrophes or quotes, use XML entities to produce smart quotes:\u003C/p>\n\u003Cdiv class=\"md-code-block\">\u003Cdiv class=\"md-code-lang\">xml\u003C/div>\u003Cpre>\u003Ccode class=\"hljs language-xml\">\u003Cspan class=\"hljs-comment\"><!-- Use these entities for professional typography -->\u003C/span>\n\u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:t\u003C/span>>\u003C/span>Here\u003Cspan class=\"hljs-symbol\">’\u003C/span>s a quote: \u003Cspan class=\"hljs-symbol\">“\u003C/span>Hello\u003Cspan class=\"hljs-symbol\">”\u003C/span>\u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:t\u003C/span>>\u003C/span>\u003C/code>\u003C/pre>\u003C/div>\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Entity\u003C/th>\n\u003Cth>Character\u003C/th>\n\u003C/tr>\n\u003C/thead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>‘\u003C/code>\u003C/td>\n\u003Ctd>‘ (left single)\u003C/td>\n\u003C/tr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>’\u003C/code>\u003C/td>\n\u003Ctd>’ (right single / apostrophe)\u003C/td>\n\u003C/tr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>“\u003C/code>\u003C/td>\n\u003Ctd>“ (left double)\u003C/td>\n\u003C/tr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>”\u003C/code>\u003C/td>\n\u003Ctd>” (right double)\u003C/td>\n\u003C/tr>\n\u003C/tbody>\u003C/table>\n\u003Cp>\u003Cstrong>Adding comments:\u003C/strong> Use \u003Ccode>comment.py\u003C/code> to handle boilerplate across multiple XML files (text must be pre-escaped XML):\u003C/p>\n\u003Cdiv class=\"md-code-block\">\u003Cdiv class=\"md-code-lang\">bash\u003C/div>\u003Cpre>\u003Ccode class=\"hljs language-bash\">python scripts/comment.py unpacked/ 0 \u003Cspan class=\"hljs-string\">"Comment text with & and ’"\u003C/span>\npython scripts/comment.py unpacked/ 1 \u003Cspan class=\"hljs-string\">"Reply text"\u003C/span> --parent 0  \u003Cspan class=\"hljs-comment\"># reply to comment 0\u003C/span>\npython scripts/comment.py unpacked/ 0 \u003Cspan class=\"hljs-string\">"Text"\u003C/span> --author \u003Cspan class=\"hljs-string\">"Custom Author"\u003C/span>  \u003Cspan class=\"hljs-comment\"># custom author name\u003C/span>\u003C/code>\u003C/pre>\u003C/div>\u003Cp>Then add markers to document.xml (see Comments in XML Reference).\u003C/p>\n\u003Ch3>Step 3: Pack\u003C/h3>\n\u003Cdiv class=\"md-code-block\">\u003Cdiv class=\"md-code-lang\">bash\u003C/div>\u003Cpre>\u003Ccode class=\"hljs language-bash\">python scripts/office/pack.py unpacked/ output.docx --original document.docx\u003C/code>\u003C/pre>\u003C/div>\u003Cp>Validates with auto-repair, condenses XML, and creates DOCX. Use \u003Ccode>--validate false\u003C/code> to skip.\u003C/p>\n\u003Cp>\u003Cstrong>Auto-repair will fix:\u003C/strong>\u003C/p>\n\u003Cul>\n\u003Cli>\u003Ccode>durableId\u003C/code> >= 0x7FFFFFFF (regenerates valid ID)\u003C/li>\n\u003Cli>Missing \u003Ccode>xml:space="preserve"\u003C/code> on \u003Ccode><w:t>\u003C/code> with whitespace\u003C/li>\n\u003C/ul>\n\u003Cp>\u003Cstrong>Auto-repair won't fix:\u003C/strong>\u003C/p>\n\u003Cul>\n\u003Cli>Malformed XML, invalid element nesting, missing relationships, schema violations\u003C/li>\n\u003C/ul>\n\u003Ch3>Common Pitfalls\u003C/h3>\n\u003Cul>\n\u003Cli>\u003Cstrong>Replace entire \u003Ccode><w:r>\u003C/code> elements\u003C/strong>: When adding tracked changes, replace the whole \u003Ccode><w:r>...</w:r>\u003C/code> block with \u003Ccode><w:del>...<w:ins>...\u003C/code> as siblings. Don't inject tracked change tags inside a run.\u003C/li>\n\u003Cli>\u003Cstrong>Preserve \u003Ccode><w:rPr>\u003C/code> formatting\u003C/strong>: Copy the original run's \u003Ccode><w:rPr>\u003C/code> block into your tracked change runs to maintain bold, font size, etc.\u003C/li>\n\u003C/ul>\n\u003Chr>\n\u003Ch2>XML Reference\u003C/h2>\n\u003Ch3>Schema Compliance\u003C/h3>\n\u003Cul>\n\u003Cli>\u003Cstrong>Element order in \u003Ccode><w:pPr>\u003C/code>\u003C/strong>: \u003Ccode><w:pStyle>\u003C/code>, \u003Ccode><w:numPr>\u003C/code>, \u003Ccode><w:spacing>\u003C/code>, \u003Ccode><w:ind>\u003C/code>, \u003Ccode><w:jc>\u003C/code>, \u003Ccode><w:rPr>\u003C/code> last\u003C/li>\n\u003Cli>\u003Cstrong>Whitespace\u003C/strong>: Add \u003Ccode>xml:space="preserve"\u003C/code> to \u003Ccode><w:t>\u003C/code> with leading/trailing spaces\u003C/li>\n\u003Cli>\u003Cstrong>RSIDs\u003C/strong>: Must be 8-digit hex (e.g., \u003Ccode>00AB1234\u003C/code>)\u003C/li>\n\u003C/ul>\n\u003Ch3>Tracked Changes\u003C/h3>\n\u003Cp>\u003Cstrong>Insertion:\u003C/strong>\u003C/p>\n\u003Cdiv class=\"md-code-block\">\u003Cdiv class=\"md-code-lang\">xml\u003C/div>\u003Cpre>\u003Ccode class=\"hljs language-xml\">\u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:ins\u003C/span> \u003Cspan class=\"hljs-attr\">w:id\u003C/span>=\u003Cspan class=\"hljs-string\">"1"\u003C/span> \u003Cspan class=\"hljs-attr\">w:author\u003C/span>=\u003Cspan class=\"hljs-string\">"Claude"\u003C/span> \u003Cspan class=\"hljs-attr\">w:date\u003C/span>=\u003Cspan class=\"hljs-string\">"2025-01-01T00:00:00Z"\u003C/span>>\u003C/span>\n  \u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:r\u003C/span>>\u003C/span>\u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:t\u003C/span>>\u003C/span>inserted text\u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:t\u003C/span>>\u003C/span>\u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:r\u003C/span>>\u003C/span>\n\u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:ins\u003C/span>>\u003C/span>\u003C/code>\u003C/pre>\u003C/div>\u003Cp>\u003Cstrong>Deletion:\u003C/strong>\u003C/p>\n\u003Cdiv class=\"md-code-block\">\u003Cdiv class=\"md-code-lang\">xml\u003C/div>\u003Cpre>\u003Ccode class=\"hljs language-xml\">\u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:del\u003C/span> \u003Cspan class=\"hljs-attr\">w:id\u003C/span>=\u003Cspan class=\"hljs-string\">"2"\u003C/span> \u003Cspan class=\"hljs-attr\">w:author\u003C/span>=\u003Cspan class=\"hljs-string\">"Claude"\u003C/span> \u003Cspan class=\"hljs-attr\">w:date\u003C/span>=\u003Cspan class=\"hljs-string\">"2025-01-01T00:00:00Z"\u003C/span>>\u003C/span>\n  \u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:r\u003C/span>>\u003C/span>\u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:delText\u003C/span>>\u003C/span>deleted text\u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:delText\u003C/span>>\u003C/span>\u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:r\u003C/span>>\u003C/span>\n\u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:del\u003C/span>>\u003C/span>\u003C/code>\u003C/pre>\u003C/div>\u003Cp>\u003Cstrong>Inside \u003Ccode><w:del>\u003C/code>\u003C/strong>: Use \u003Ccode><w:delText>\u003C/code> instead of \u003Ccode><w:t>\u003C/code>, and \u003Ccode><w:delInstrText>\u003C/code> instead of \u003Ccode><w:instrText>\u003C/code>.\u003C/p>\n\u003Cp>\u003Cstrong>Minimal edits\u003C/strong> - only mark what changes:\u003C/p>\n\u003Cdiv class=\"md-code-block\">\u003Cdiv class=\"md-code-lang\">xml\u003C/div>\u003Cpre>\u003Ccode class=\"hljs language-xml\">\u003Cspan class=\"hljs-comment\"><!-- Change "30 days" to "60 days" -->\u003C/span>\n\u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:r\u003C/span>>\u003C/span>\u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:t\u003C/span>>\u003C/span>The term is \u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:t\u003C/span>>\u003C/span>\u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:r\u003C/span>>\u003C/span>\n\u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:del\u003C/span> \u003Cspan class=\"hljs-attr\">w:id\u003C/span>=\u003Cspan class=\"hljs-string\">"1"\u003C/span> \u003Cspan class=\"hljs-attr\">w:author\u003C/span>=\u003Cspan class=\"hljs-string\">"Claude"\u003C/span> \u003Cspan class=\"hljs-attr\">w:date\u003C/span>=\u003Cspan class=\"hljs-string\">"..."\u003C/span>>\u003C/span>\n  \u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:r\u003C/span>>\u003C/span>\u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:delText\u003C/span>>\u003C/span>30\u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:delText\u003C/span>>\u003C/span>\u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:r\u003C/span>>\u003C/span>\n\u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:del\u003C/span>>\u003C/span>\n\u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:ins\u003C/span> \u003Cspan class=\"hljs-attr\">w:id\u003C/span>=\u003Cspan class=\"hljs-string\">"2"\u003C/span> \u003Cspan class=\"hljs-attr\">w:author\u003C/span>=\u003Cspan class=\"hljs-string\">"Claude"\u003C/span> \u003Cspan class=\"hljs-attr\">w:date\u003C/span>=\u003Cspan class=\"hljs-string\">"..."\u003C/span>>\u003C/span>\n  \u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:r\u003C/span>>\u003C/span>\u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:t\u003C/span>>\u003C/span>60\u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:t\u003C/span>>\u003C/span>\u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:r\u003C/span>>\u003C/span>\n\u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:ins\u003C/span>>\u003C/span>\n\u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:r\u003C/span>>\u003C/span>\u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:t\u003C/span>>\u003C/span> days.\u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:t\u003C/span>>\u003C/span>\u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:r\u003C/span>>\u003C/span>\u003C/code>\u003C/pre>\u003C/div>\u003Cp>\u003Cstrong>Deleting entire paragraphs/list items\u003C/strong> - when removing ALL content from a paragraph, also mark the paragraph mark as deleted so it merges with the next paragraph. Add \u003Ccode><w:del/>\u003C/code> inside \u003Ccode><w:pPr><w:rPr>\u003C/code>:\u003C/p>\n\u003Cdiv class=\"md-code-block\">\u003Cdiv class=\"md-code-lang\">xml\u003C/div>\u003Cpre>\u003Ccode class=\"hljs language-xml\">\u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:p\u003C/span>>\u003C/span>\n  \u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:pPr\u003C/span>>\u003C/span>\n    \u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:numPr\u003C/span>>\u003C/span>...\u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:numPr\u003C/span>>\u003C/span>  \u003Cspan class=\"hljs-comment\"><!-- list numbering if present -->\u003C/span>\n    \u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:rPr\u003C/span>>\u003C/span>\n      \u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:del\u003C/span> \u003Cspan class=\"hljs-attr\">w:id\u003C/span>=\u003Cspan class=\"hljs-string\">"1"\u003C/span> \u003Cspan class=\"hljs-attr\">w:author\u003C/span>=\u003Cspan class=\"hljs-string\">"Claude"\u003C/span> \u003Cspan class=\"hljs-attr\">w:date\u003C/span>=\u003Cspan class=\"hljs-string\">"2025-01-01T00:00:00Z"\u003C/span>/>\u003C/span>\n    \u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:rPr\u003C/span>>\u003C/span>\n  \u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:pPr\u003C/span>>\u003C/span>\n  \u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:del\u003C/span> \u003Cspan class=\"hljs-attr\">w:id\u003C/span>=\u003Cspan class=\"hljs-string\">"2"\u003C/span> \u003Cspan class=\"hljs-attr\">w:author\u003C/span>=\u003Cspan class=\"hljs-string\">"Claude"\u003C/span> \u003Cspan class=\"hljs-attr\">w:date\u003C/span>=\u003Cspan class=\"hljs-string\">"2025-01-01T00:00:00Z"\u003C/span>>\u003C/span>\n    \u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:r\u003C/span>>\u003C/span>\u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:delText\u003C/span>>\u003C/span>Entire paragraph content being deleted...\u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:delText\u003C/span>>\u003C/span>\u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:r\u003C/span>>\u003C/span>\n  \u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:del\u003C/span>>\u003C/span>\n\u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:p\u003C/span>>\u003C/span>\u003C/code>\u003C/pre>\u003C/div>\u003Cp>Without the \u003Ccode><w:del/>\u003C/code> in \u003Ccode><w:pPr><w:rPr>\u003C/code>, accepting changes leaves an empty paragraph/list item.\u003C/p>\n\u003Cp>\u003Cstrong>Rejecting another author's insertion\u003C/strong> - nest deletion inside their insertion:\u003C/p>\n\u003Cdiv class=\"md-code-block\">\u003Cdiv class=\"md-code-lang\">xml\u003C/div>\u003Cpre>\u003Ccode class=\"hljs language-xml\">\u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:ins\u003C/span> \u003Cspan class=\"hljs-attr\">w:author\u003C/span>=\u003Cspan class=\"hljs-string\">"Jane"\u003C/span> \u003Cspan class=\"hljs-attr\">w:id\u003C/span>=\u003Cspan class=\"hljs-string\">"5"\u003C/span>>\u003C/span>\n  \u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:del\u003C/span> \u003Cspan class=\"hljs-attr\">w:author\u003C/span>=\u003Cspan class=\"hljs-string\">"Claude"\u003C/span> \u003Cspan class=\"hljs-attr\">w:id\u003C/span>=\u003Cspan class=\"hljs-string\">"10"\u003C/span>>\u003C/span>\n    \u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:r\u003C/span>>\u003C/span>\u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:delText\u003C/span>>\u003C/span>their inserted text\u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:delText\u003C/span>>\u003C/span>\u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:r\u003C/span>>\u003C/span>\n  \u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:del\u003C/span>>\u003C/span>\n\u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:ins\u003C/span>>\u003C/span>\u003C/code>\u003C/pre>\u003C/div>\u003Cp>\u003Cstrong>Restoring another author's deletion\u003C/strong> - add insertion after (don't modify their deletion):\u003C/p>\n\u003Cdiv class=\"md-code-block\">\u003Cdiv class=\"md-code-lang\">xml\u003C/div>\u003Cpre>\u003Ccode class=\"hljs language-xml\">\u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:del\u003C/span> \u003Cspan class=\"hljs-attr\">w:author\u003C/span>=\u003Cspan class=\"hljs-string\">"Jane"\u003C/span> \u003Cspan class=\"hljs-attr\">w:id\u003C/span>=\u003Cspan class=\"hljs-string\">"5"\u003C/span>>\u003C/span>\n  \u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:r\u003C/span>>\u003C/span>\u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:delText\u003C/span>>\u003C/span>deleted text\u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:delText\u003C/span>>\u003C/span>\u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:r\u003C/span>>\u003C/span>\n\u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:del\u003C/span>>\u003C/span>\n\u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:ins\u003C/span> \u003Cspan class=\"hljs-attr\">w:author\u003C/span>=\u003Cspan class=\"hljs-string\">"Claude"\u003C/span> \u003Cspan class=\"hljs-attr\">w:id\u003C/span>=\u003Cspan class=\"hljs-string\">"10"\u003C/span>>\u003C/span>\n  \u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:r\u003C/span>>\u003C/span>\u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:t\u003C/span>>\u003C/span>deleted text\u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:t\u003C/span>>\u003C/span>\u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:r\u003C/span>>\u003C/span>\n\u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:ins\u003C/span>>\u003C/span>\u003C/code>\u003C/pre>\u003C/div>\u003Ch3>Comments\u003C/h3>\n\u003Cp>After running \u003Ccode>comment.py\u003C/code> (see Step 2), add markers to document.xml. For replies, use \u003Ccode>--parent\u003C/code> flag and nest markers inside the parent's.\u003C/p>\n\u003Cp>\u003Cstrong>CRITICAL: \u003Ccode><w:commentRangeStart>\u003C/code> and \u003Ccode><w:commentRangeEnd>\u003C/code> are siblings of \u003Ccode><w:r>\u003C/code>, never inside \u003Ccode><w:r>\u003C/code>.\u003C/strong>\u003C/p>\n\u003Cdiv class=\"md-code-block\">\u003Cdiv class=\"md-code-lang\">xml\u003C/div>\u003Cpre>\u003Ccode class=\"hljs language-xml\">\u003Cspan class=\"hljs-comment\"><!-- Comment markers are direct children of w:p, never inside w:r -->\u003C/span>\n\u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:commentRangeStart\u003C/span> \u003Cspan class=\"hljs-attr\">w:id\u003C/span>=\u003Cspan class=\"hljs-string\">"0"\u003C/span>/>\u003C/span>\n\u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:del\u003C/span> \u003Cspan class=\"hljs-attr\">w:id\u003C/span>=\u003Cspan class=\"hljs-string\">"1"\u003C/span> \u003Cspan class=\"hljs-attr\">w:author\u003C/span>=\u003Cspan class=\"hljs-string\">"Claude"\u003C/span> \u003Cspan class=\"hljs-attr\">w:date\u003C/span>=\u003Cspan class=\"hljs-string\">"2025-01-01T00:00:00Z"\u003C/span>>\u003C/span>\n  \u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:r\u003C/span>>\u003C/span>\u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:delText\u003C/span>>\u003C/span>deleted\u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:delText\u003C/span>>\u003C/span>\u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:r\u003C/span>>\u003C/span>\n\u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:del\u003C/span>>\u003C/span>\n\u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:r\u003C/span>>\u003C/span>\u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:t\u003C/span>>\u003C/span> more text\u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:t\u003C/span>>\u003C/span>\u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:r\u003C/span>>\u003C/span>\n\u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:commentRangeEnd\u003C/span> \u003Cspan class=\"hljs-attr\">w:id\u003C/span>=\u003Cspan class=\"hljs-string\">"0"\u003C/span>/>\u003C/span>\n\u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:r\u003C/span>>\u003C/span>\u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:rPr\u003C/span>>\u003C/span>\u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:rStyle\u003C/span> \u003Cspan class=\"hljs-attr\">w:val\u003C/span>=\u003Cspan class=\"hljs-string\">"CommentReference"\u003C/span>/>\u003C/span>\u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:rPr\u003C/span>>\u003C/span>\u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:commentReference\u003C/span> \u003Cspan class=\"hljs-attr\">w:id\u003C/span>=\u003Cspan class=\"hljs-string\">"0"\u003C/span>/>\u003C/span>\u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:r\u003C/span>>\u003C/span>\n\n\u003Cspan class=\"hljs-comment\"><!-- Comment 0 with reply 1 nested inside -->\u003C/span>\n\u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:commentRangeStart\u003C/span> \u003Cspan class=\"hljs-attr\">w:id\u003C/span>=\u003Cspan class=\"hljs-string\">"0"\u003C/span>/>\u003C/span>\n  \u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:commentRangeStart\u003C/span> \u003Cspan class=\"hljs-attr\">w:id\u003C/span>=\u003Cspan class=\"hljs-string\">"1"\u003C/span>/>\u003C/span>\n  \u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:r\u003C/span>>\u003C/span>\u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:t\u003C/span>>\u003C/span>text\u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:t\u003C/span>>\u003C/span>\u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:r\u003C/span>>\u003C/span>\n  \u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:commentRangeEnd\u003C/span> \u003Cspan class=\"hljs-attr\">w:id\u003C/span>=\u003Cspan class=\"hljs-string\">"1"\u003C/span>/>\u003C/span>\n\u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:commentRangeEnd\u003C/span> \u003Cspan class=\"hljs-attr\">w:id\u003C/span>=\u003Cspan class=\"hljs-string\">"0"\u003C/span>/>\u003C/span>\n\u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:r\u003C/span>>\u003C/span>\u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:rPr\u003C/span>>\u003C/span>\u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:rStyle\u003C/span> \u003Cspan class=\"hljs-attr\">w:val\u003C/span>=\u003Cspan class=\"hljs-string\">"CommentReference"\u003C/span>/>\u003C/span>\u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:rPr\u003C/span>>\u003C/span>\u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:commentReference\u003C/span> \u003Cspan class=\"hljs-attr\">w:id\u003C/span>=\u003Cspan class=\"hljs-string\">"0"\u003C/span>/>\u003C/span>\u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:r\u003C/span>>\u003C/span>\n\u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:r\u003C/span>>\u003C/span>\u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:rPr\u003C/span>>\u003C/span>\u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:rStyle\u003C/span> \u003Cspan class=\"hljs-attr\">w:val\u003C/span>=\u003Cspan class=\"hljs-string\">"CommentReference"\u003C/span>/>\u003C/span>\u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:rPr\u003C/span>>\u003C/span>\u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:commentReference\u003C/span> \u003Cspan class=\"hljs-attr\">w:id\u003C/span>=\u003Cspan class=\"hljs-string\">"1"\u003C/span>/>\u003C/span>\u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:r\u003C/span>>\u003C/span>\u003C/code>\u003C/pre>\u003C/div>\u003Ch3>Images\u003C/h3>\n\u003Col>\n\u003Cli>Add image file to \u003Ccode>word/media/\u003C/code>\u003C/li>\n\u003Cli>Add relationship to \u003Ccode>word/_rels/document.xml.rels\u003C/code>:\u003C/li>\n\u003C/ol>\n\u003Cdiv class=\"md-code-block\">\u003Cdiv class=\"md-code-lang\">xml\u003C/div>\u003Cpre>\u003Ccode class=\"hljs language-xml\">\u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">Relationship\u003C/span> \u003Cspan class=\"hljs-attr\">Id\u003C/span>=\u003Cspan class=\"hljs-string\">"rId5"\u003C/span> \u003Cspan class=\"hljs-attr\">Type\u003C/span>=\u003Cspan class=\"hljs-string\">".../image"\u003C/span> \u003Cspan class=\"hljs-attr\">Target\u003C/span>=\u003Cspan class=\"hljs-string\">"media/image1.png"\u003C/span>/>\u003C/span>\u003C/code>\u003C/pre>\u003C/div>\u003Col start=\"3\">\n\u003Cli>Add content type to \u003Ccode>[Content_Types].xml\u003C/code>:\u003C/li>\n\u003C/ol>\n\u003Cdiv class=\"md-code-block\">\u003Cdiv class=\"md-code-lang\">xml\u003C/div>\u003Cpre>\u003Ccode class=\"hljs language-xml\">\u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">Default\u003C/span> \u003Cspan class=\"hljs-attr\">Extension\u003C/span>=\u003Cspan class=\"hljs-string\">"png"\u003C/span> \u003Cspan class=\"hljs-attr\">ContentType\u003C/span>=\u003Cspan class=\"hljs-string\">"image/png"\u003C/span>/>\u003C/span>\u003C/code>\u003C/pre>\u003C/div>\u003Col start=\"4\">\n\u003Cli>Reference in document.xml:\u003C/li>\n\u003C/ol>\n\u003Cdiv class=\"md-code-block\">\u003Cdiv class=\"md-code-lang\">xml\u003C/div>\u003Cpre>\u003Ccode class=\"hljs language-xml\">\u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">w:drawing\u003C/span>>\u003C/span>\n  \u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">wp:inline\u003C/span>>\u003C/span>\n    \u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">wp:extent\u003C/span> \u003Cspan class=\"hljs-attr\">cx\u003C/span>=\u003Cspan class=\"hljs-string\">"914400"\u003C/span> \u003Cspan class=\"hljs-attr\">cy\u003C/span>=\u003Cspan class=\"hljs-string\">"914400"\u003C/span>/>\u003C/span>  \u003Cspan class=\"hljs-comment\"><!-- EMUs: 914400 = 1 inch -->\u003C/span>\n    \u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">a:graphic\u003C/span>>\u003C/span>\n      \u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">a:graphicData\u003C/span> \u003Cspan class=\"hljs-attr\">uri\u003C/span>=\u003Cspan class=\"hljs-string\">".../picture"\u003C/span>>\u003C/span>\n        \u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">pic:pic\u003C/span>>\u003C/span>\n          \u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">pic:blipFill\u003C/span>>\u003C/span>\u003Cspan class=\"hljs-tag\"><\u003Cspan class=\"hljs-name\">a:blip\u003C/span> \u003Cspan class=\"hljs-attr\">r:embed\u003C/span>=\u003Cspan class=\"hljs-string\">"rId5"\u003C/span>/>\u003C/span>\u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">pic:blipFill\u003C/span>>\u003C/span>\n        \u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">pic:pic\u003C/span>>\u003C/span>\n      \u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">a:graphicData\u003C/span>>\u003C/span>\n    \u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">a:graphic\u003C/span>>\u003C/span>\n  \u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">wp:inline\u003C/span>>\u003C/span>\n\u003Cspan class=\"hljs-tag\"></\u003Cspan class=\"hljs-name\">w:drawing\u003C/span>>\u003C/span>\u003C/code>\u003C/pre>\u003C/div>\u003Chr>\n\u003Ch2>Dependencies\u003C/h2>\n\u003Cul>\n\u003Cli>\u003Cstrong>pandoc\u003C/strong>: Text extraction\u003C/li>\n\u003Cli>\u003Cstrong>docx\u003C/strong>: \u003Ccode>npm install -g docx\u003C/code> (new documents)\u003C/li>\n\u003Cli>\u003Cstrong>LibreOffice\u003C/strong>: PDF conversion (auto-configured for sandboxed environments via \u003Ccode>scripts/office/soffice.py\u003C/code>)\u003C/li>\n\u003Cli>\u003Cstrong>Poppler\u003C/strong>: \u003Ccode>pdftoppm\u003C/code> for images\u003C/li>\n\u003C/ul>\n"]