Skip to main content

DOCX Editor by EigenPal

DOCX to Markdown for Python

Convert Word documents to Markdown, with individual pages, headers, footers, comments, and tracked changes.

Install

Use Python 3.11 or later. Install the package with pip:

pip install docx-to-markdown

Usage

Convert a file and read its document and page output:

from docx_to_markdown import convert

result = convert("contract.docx")
print(result.markdown)

for page in result.pages:
    print(f"Page {page.number}", page.markdown)
    print(page.header_markdown, page.footer_markdown)

result.markdown contains the document body; headers and footers stay in result.pages. Input can be a file path, bytes, or a binary file object.

Options

Enable images, supply font files, and choose a tracked-change view:

result = convert(
    "contract.docx",
    images=True,
    fonts="fonts/",
    google_fonts=True,
    display_mode="proposed",
)
result.write("out/")  # document.md, document.json, media/
  • images=True extracts images; images="html" also preserves displayed sizes.
  • fonts accepts font files or directories. Common Word font substitutes are bundled.
  • google_fonts=True fetches missing fonts from a pinned Google Fonts catalog (requires network access). Use google_font_families() to list supported families and result.missing_fonts to check what still needs local font files.
  • display_mode selects tracked changes: "all-markup" (default), "proposed" (accepted view), or "original" (rejected view).

Comments and tracked changes are available in result.comments and result.tracked_changes. Page breaks can differ from Word; check result.warnings for conversion issues.

Batch conversion

Reuse one converter process for multiple files:

from pathlib import Path
from docx_to_markdown import Converter

with Converter() as converter:
    for path in Path("contracts").glob("*.docx"):
        result = converter.convert(path)
        result.write(Path("output") / path.stem)

Command line

Write Markdown to standard output, save a file, or export a bundle:

docx-to-markdown contract.docx                 # Markdown to stdout
docx-to-markdown contract.docx -o contract.md
docx-to-markdown contract.docx --json
docx-to-markdown *.docx --bundle out/ --images

Documentation · Try the demo · PyPI · Changelog

License

Apache 2.0. Bundled dependencies and fonts retain their own licenses; notices are included in the package.

Metadata

Release files for docx-to-markdown 2.33.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distributions (wheels)

Table of built distributions (wheels) for docx-to-markdown 2.33.0
File Actions
docx_to_markdown-2.33.0-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details for docx_to_markdown-2.33.0-py3-none-win_amd64.whl
docx_to_markdown-2.33.0-py3-none-manylinux_2_17_x86_64.whl Python 3 none Linux glibc 2.17+ x86-64 Details for docx_to_markdown-2.33.0-py3-none-manylinux_2_17_x86_64.whl
docx_to_markdown-2.33.0-py3-none-manylinux_2_17_aarch64.whl Python 3 none Linux glibc 2.17+ ARM64 Details for docx_to_markdown-2.33.0-py3-none-manylinux_2_17_aarch64.whl
docx_to_markdown-2.33.0-py3-none-macosx_13_0_x86_64.whl Python 3 none macOS 13.0+ x86-64 Details for docx_to_markdown-2.33.0-py3-none-macosx_13_0_x86_64.whl
docx_to_markdown-2.33.0-py3-none-macosx_13_0_arm64.whl Python 3 none macOS 13.0+ ARM64 Details for docx_to_markdown-2.33.0-py3-none-macosx_13_0_arm64.whl

Total release size: 268.8 MB

Release files / docx_to_markdown-2.33.0-py3-none-win_amd64.whl

Download URL docx_to_markdown-2.33.0-py3-none-win_amd64.whl
Size 60.0 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
5bf4bf9d1ea51ab7ef473164a6bbf485b5824f16c561aaea855339cd2702734b
BLAKE2b-256 checksum
How to use checksums
e5ae63e2a02455961d9af5715faf14887fd498c3c7d937c43cc4de0472e6f904
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 27, 2026.

Transparency log

Release files / docx_to_markdown-2.33.0-py3-none-manylinux_2_17_x86_64.whl

Download URL docx_to_markdown-2.33.0-py3-none-manylinux_2_17_x86_64.whl
Size 57.1 MB
Tags Linux glibc 2.17+ x86-64 Python 3
SHA-256 checksum
How to use checksums
08812fe6587855000ac5712d75566563442dbb8a6309433f40e8cb0acbc6c3f4
BLAKE2b-256 checksum
How to use checksums
39dcda216a7d5b4290e8e72d16176027702af1e017e5ebc5d5011f1f9a631391
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 27, 2026.

Transparency log

Release files / docx_to_markdown-2.33.0-py3-none-manylinux_2_17_aarch64.whl

Download URL docx_to_markdown-2.33.0-py3-none-manylinux_2_17_aarch64.whl
Size 56.9 MB
Tags Linux glibc 2.17+ ARM64 Python 3
SHA-256 checksum
How to use checksums
89f51cda3f6058d3e8804dc5d1942ef9651c0d6cb3606c33647816bbd58a17bf
BLAKE2b-256 checksum
How to use checksums
fea83ae1e0af2381ccf59f9343e7eefe3f165f9f69cc61a57eebacfa744f5253
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 27, 2026.

Transparency log

Release files / docx_to_markdown-2.33.0-py3-none-macosx_13_0_x86_64.whl

Download URL docx_to_markdown-2.33.0-py3-none-macosx_13_0_x86_64.whl
Size 48.7 MB
Tags Python 3 macOS 13.0+ x86-64
SHA-256 checksum
How to use checksums
ed92beb8e0345c79a88de4e47311565030907fd8159b9fe2e7563aa2168992dc
BLAKE2b-256 checksum
How to use checksums
41e2af40cbf1d302da0021781f50fcd984ecb42a17137794fdceed39d1ec3022
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 27, 2026.

Transparency log

Release files / docx_to_markdown-2.33.0-py3-none-macosx_13_0_arm64.whl

Download URL docx_to_markdown-2.33.0-py3-none-macosx_13_0_arm64.whl
Size 46.1 MB
Tags Python 3 macOS 13.0+ ARM64
SHA-256 checksum
How to use checksums
834b4572fda02c620456e867104c5ace5becd99b3db40152560aaf8bfe2e7a10
BLAKE2b-256 checksum
How to use checksums
217bf8c1c45cfb05d1f1027ade9ce52e9f156db6626ded97892893e8dfd505bc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 27, 2026.

Transparency log

Security for docx-to-markdown 2.33.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 5 files in this release have been uploaded with provenance metadata.

Select from 5 files

Attestation for docx_to_markdown-2.33.0-py3-none-win_amd64.whl

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 27, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page