Skip to main content

Extracts tables from .docx files and saves them as csv or xlsx

Project description

Usage: docx2csv [OPTIONS] FILENAME

docx to csv convertor ( Extracts tables from DOCX files as CSV or XLSX.

Use command: “docx2csv convert <filename>” to run extraction. It will create files like filename_1.csv, filename_2.csv for each table found.

--format TEXT

Output format: CSV, XLSX

--singlefile TEXT

Outputs single XLS file with multiple sheets: True or False

--sizefilter INTEGER

Filters table by size number of rows


Show this message and exit.


docx2csv –format csv –sizefilter 3 CP_CONTRACT_160166.docx

Extracts tables from file CP_CONTRACT_160166.docx with number of rows > 3 and saves results as CSV files.


Function “extract_tables” returns list of tables from docx file and function “extract” extracts tables as xlsx, xls or csv file. If ‘csv’ file selected you need to specify single file csv or multiple files
>>> from docx2csv import extract_tables, extract
>>> tables = extract_tables('some_file.docx')

returns list of tables >>> extract(filename=’some_file.docx’, format=”xlsx”, output=’some_file.xlsx’) saves all tables from some_file.docx to some_file.xlsx

>>> extract(filename='some_file.docx', format="csv", singlefile=False)
saves all tables from some_file.docx to some_file_1.csv, some_file_2.csv and etc.



Thanks to Vsevolod Oparin ( for optimized “extract_table” code


0.1.1 (2022-01-30)

  • Fixed requirements.txt and requirements

0.1.0 (2018-01-14)

  • First public release on PyPI and updated github code

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

docx2csv-0.1.1.tar.gz (5.0 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page