Convert DOCX

Convert Word (.docx) files to clean markdown for LLM context (uses markitdown). Use when converting Word documents to markdown for analysis or summarization. Triggers include "convert docx", "word to markdown", "docx file".

digital-stoic-org Updated

File contents

Convert DOCX → Markdown

Convert the Word document at $1 to clean markdown format optimized for LLM context.

Steps

  1. Install dependency: Use toolsmith:install-dependency skill to ensure markitdown is installed
  2. Parse arguments: Input file $1 (required), output dir $2 (optional, defaults to ./converted/)
  3. Prepare output dir: Create $2 if it doesn't exist
  4. Convert:
    source .venv/bin/activate && python -m markitdown "$1" -o "$OUTPUT_DIR/output.md"
    
  5. Report: Output location, file sizes (original vs converted), structure summary (headings, tables, lists), any warnings

Goal

Extract clean markdown for LLM context — analysis, summarization, Q&A. NOT for round-tripping back to DOCX.

No content sent to any LLM during conversion (pure script-based extraction).

digital-stoic-org/agent-skills/tree/main/convert/skills/convert-docx commit 8a6934110b

Frequently asked questions

npx skillmds@latest add digital-stoic-org/convert-docx