docx2csv

Extracts tables from .docx files and saves them as CSV, TSV, XLSX, or JSON.

Installation

pip install docx2csv

For XLS (Excel 97) output support:

pip install docx2csv[xls]

Quick Start

Command Line

# Extract all tables as separate CSV files
docx2csv extract document.docx

# Extract as XLSX
docx2csv extract document.docx --format xlsx

# Extract as single CSV file with all tables
docx2csv extract document.docx --format csv --singlefile

# Filter tables by minimum row count
docx2csv extract document.docx --sizefilter 3

# Specify output location
docx2csv extract document.docx --output results.csv

# Analyze a document (list tables without extracting)
docx2csv analyze document.docx

Python API

from docx2csv import extract_tables, extract, analyze

# Get table data as Python objects
tables = extract_tables('document.docx')
for table in tables:
    print(f"Table {table['id']}: {table['num_rows']} rows x {table['num_cols']} cols")
    for row in table['data']:
        print(row)

# Extract to file
extract('document.docx', format='xlsx', output='output.xlsx')

# Analyze document structure
info = analyze('document.docx')

Output Formats

Requirements

• click
• python-docx
• openpyxl

Contributing

Contributions are welcome! Every little bit helps.

1. Fork the repo on GitHub
2. Clone your fork: git clone https://github.com/your-username/docx2csv.git
3. Create a branch: git checkout -b name-of-your-bugfix-or-feature
4. Make your changes and add tests
5. Run tests: pytest
6. Commit and push: git commit -m "Your message" && git push origin your-branch
7. Submit a pull request

Credits

• Ivan Begtin - Author and maintainer
• Vsevolod Oparin - Optimized table extraction code

License

BSD 3-Clause License. See LICENSE for details.