docx-to-mdlisted

# Docx To Md > Ingest Word documents into your Markdown workflow — clean, linted, version-control ready Convert .docx files into clean, linted Markdown with extracted images, normalized headings, and cleaned table formatting. The reverse converter for ingesting external documents into a Markdown-based workflow. --- ## When to Use - Importing Word documents from stakeholders into a Markdown-based workflow - Converting legacy documentation to Markdown for version control - Extracting content from .docx for further processing (presentations, email, web) - Onboarding external resources (SOWs, RFPs, specs) into project repositories - Migrating from Word-based documentation to docs-as-code - Preparing content for static site generators (VitePress, Docusaurus, etc.) --- ## Supported Content | Content Type | Status | Notes | |--------------|--------|-------| | **Headings** | ✅ | Hierarchy normalized to start at H1 | | **Bold/Italic** | ✅ | Converted to Markdown syntax | | **Links** | ✅ | Preserved as Markdown links | | **Images** | ✅ | Extracted to images/ folder | | **Tables** | ✅ | Cleaned and aligned | | **Lists** | ✅ | Ordered, unordered, nested | | **Code blocks** | ⚠️ | Detected if styled as code | | **Footnotes** | ✅ | Converted to Markdown footnotes | | **Comments** | ⚠️ | Stripped with `--strip-comments` | | **Track changes** | ❌ | Accept/reject before converting | | **Embedded objects** | ❌ | Extract manually | --- ## Key Features | Feature | Details | |---------