Doc To Markdown#

Convert Word (.doc/.docx) documents to clean Markdown using MinerU.

Install#

bash

npm install -g mineru-open-api
# or via Go (macOS/Linux):
go install github.com/opendatalab/MinerU-Ecosystem/cli/mineru-open-api@latest

Quick Start#

bash

# Quick conversion from .docx (no token required)
mineru-open-api flash-extract report.docx

# Save Markdown to directory
mineru-open-api flash-extract report.docx -o ./out/

# Convert .doc to Markdown (requires token)
mineru-open-api extract report.doc -o ./out/

# With language hint
mineru-open-api flash-extract report.docx --language en

Authentication#

No token needed for flash-extract on .docx. Token required for .doc:

bash

mineru-open-api auth             # Interactive token setup
export MINERU_TOKEN="your-token" # Or via environment variable

Create token at: https://mineru.net/apiManage/token

Capabilities#

• Supported input: .doc, .docx (local file or URL)
• .docx: supports flash-extract (no token, max 10 MB / 20 pages, Markdown output)
• .doc: requires extract with token
• Language hint with --language (default: ch, use en for English)
• Page range with --pages (e.g. 1-10)

Notes#

• .docx supports flash-extract (quick, no token); .doc requires extract with token
• Output goes to stdout by default; use -o <dir> to save to a file or directory
• All progress/status messages go to stderr; document content goes to stdout
• MinerU is open-source by OpenDataLab (Shanghai AI Lab): https://github.com/opendatalab/MinerU