# 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".

- Skill: `digital-stoic-org/convert-docx` (Agent Skill)
- Install (CLI): `npx skillmds@latest add digital-stoic-org/convert-docx`
- Raw SKILL.md: https://api.skillmd.com/api/skills/digital-stoic-org/convert-docx/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: digital-stoic-org (https://skillmd.com/u/digital-stoic-org)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/digital-stoic-org/convert-docx

---


# 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**:
   ```bash
   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).