docx

DOCX Skill

Criar, editar e analisar documentos Word. docx-js para criacao, OOXML para edicao, pandoc para extracao.

Workflow Decision Tree

Quer o que?
├── Ler/extrair texto     → pandoc ou python-docx
├── Criar do zero         → docx-js (Node) ou python-docx
├── Editar existente      → OOXML unpack/edit/pack
├── Tracked changes       → OOXML XML direto (w:ins, w:del)
├── Converter para PDF    → LibreOffice headless
└── Converter para imagem → LibreOffice + ImageMagick

Reading Content

pandoc (text extraction)

# To plain text
pandoc input.docx -t plain -o output.txt

# To markdown
pandoc input.docx -t markdown -o output.md

# To HTML
pandoc input.docx -t html -o output.html

python-docx (structured reading)

from docx import Document
doc = Document("input.docx")

# Paragraphs
for para in doc.paragraphs:
    print(f"[{para.style.name}] {para.text}")

# Tables
for table in doc.tables:
    for row in table.rows:
        print([cell.text for cell in row.cells])

Raw XML inspection

unzip -p input.docx word/document.xml | xmllint --format -

Creating with docx-js (Node)

npm install docx

import { Document, Packer, Paragraph, TextRun, HeadingLevel,
         Table, TableRow, TableCell, WidthType, BorderStyle,
         AlignmentType, PageBreak, Header, Footer,
         ImageRun, NumberFormat } from "docx";
import * as fs from "fs";

const doc = new Document({
  sections: [{
    properties: {
      page: {
        size: { width: 11906, height: 16838 }, // A4 in twips
        margin: { top: 1440, right: 1440, bottom: 1440, left: 1440 }, // 1 inch
      },
    },
    headers: {
      default: new Header({
        children: [new Paragraph({ text: "Header Text", alignment: AlignmentType.RIGHT })],
      }),
    },
    footers: {
      default: new Footer({
        children: [new Paragraph({
          children: [new TextRun("Page "), new TextRun({ children: [PageNumber.CURRENT] })],
          alignment: AlignmentType.CENTER,
        })],
      }),
    },
    children: [
      // Title
      new Paragraph({
        text: "Document Title",
        heading: HeadingLevel.TITLE,
        alignment: AlignmentType.CENTER,
        spacing: { after: 400 },
      }),

      // Heading
      new Paragraph({
        text: "Section 1",
        heading: HeadingLevel.HEADING_1,
        spacing: { before: 240, after: 120 },
      }),

      // Body text with formatting
      new Paragraph({
        children: [
          new TextRun("Normal text, "),
          new TextRun({ text: "bold text", bold: true }),
          new TextRun(", "),
          new TextRun({ text: "italic text", italics: true }),
          new TextRun(", "),
          new TextRun({ text: "colored text", color: "FF0000" }),
        ],
        spacing: { after: 200 },
      }),

      // Bulleted list
      new Paragraph({ text: "First item", bullet: { level: 0 } }),
      new Paragraph({ text: "Second item", bullet: { level: 0 } }),
      new Paragraph({ text: "Sub-item", bullet: { level: 1 } }),

      // Numbered list
      new Paragraph({
        text: "Step one",
        numbering: { reference: "numbered-list", level: 0 },
      }),

      // Table
      new Table({
        rows: [
          new TableRow({
            children: [
              new TableCell({
                children: [new Paragraph({ text: "Header 1", bold: true })],
                width: { size: 3000, type: WidthType.DXA },
                shading: { fill: "1a1a2e" },
              }),
              new TableCell({
                children: [new Paragraph({ text: "Header 2", bold: true })],
                width: { size: 3000, type: WidthType.DXA },
                shading: { fill: "1a1a2e" },
              }),
            ],
          }),
          new TableRow({
            children: [
              new TableCell({ children: [new Paragraph("Value 1")] }),
              new TableCell({ children: [new Paragraph("Value 2")] }),
            ],
          }),
        ],
        width: { size: 100, type: WidthType.PERCENTAGE },
      }),

      // Page break
      new Paragraph({ children: [new PageBreak()] }),

      // Image
      new Paragraph({
        children: [
          new ImageRun({
            data: fs.readFileSync("image.png"),
            transformation: { width: 400, height: 300 },
            type: "png",
          }),
        ],
      }),
    ],
  }],
  // Numbering definitions
  numbering: {
    config: [{
      reference: "numbered-list",
      levels: [{
        level: 0,
        format: NumberFormat.DECIMAL,
        text: "%1.",
        alignment: AlignmentType.START,
      }],
    }],
  },
});

// Generate file
const buffer = await Packer.toBuffer(doc);
fs.writeFileSync("output.docx", buffer);