eqword2llm 0.2.1

Convert equation-heavy Word documents (.docx) to Markdown with LaTeX math for LLM recognition.

eqword2llm

Equation Word → LLM: Convert equation-heavy Word documents (.docx) to Markdown with LaTeX math for LLM recognition.

Why eqword2llm?

Most Word-to-Markdown converters ignore or break mathematical equations. eqword2llm is specifically designed for scientific and technical documents where math equations are critical.

Features

• 🔢 Math equation conversion - OMML to LaTeX (inline $...$ and block $$...$$)
• 🔖 Automatic equation numbering - Block equations get \tag{N} (can be disabled)
• 🤖 LLM-optimized output - Clean Markdown that LLMs can understand
• 🌍 Full Unicode support - Japanese, Chinese, Korean, and more
• 📊 Tables, lists, headings, formatting support
• 🐍 Zero dependencies - Python standard library only

Installation

# PyPI
pip install eqword2llm

# or with uv
uv add eqword2llm

Quick Start

Command Line

# Output to stdout (with equation numbers by default)
eqword2llm document.docx

# Output to file
eqword2llm document.docx -o output.md

# Disable equation numbering
eqword2llm document.docx -o output.md --no-equation-numbers

Python API

from eqword2llm import WordToMarkdownConverter

# With equation numbers (default)
converter = WordToMarkdownConverter("research_paper.docx")
markdown = converter.convert()

# Without equation numbers
converter = WordToMarkdownConverter("research_paper.docx", equation_numbers=False)
markdown = converter.convert()

With LLM APIs

import anthropic
from eqword2llm import WordToMarkdownConverter

# Convert Word document with equations
converter = WordToMarkdownConverter("math_paper.docx")
markdown = converter.convert()

# Send to Claude - equations are now readable!
client = anthropic.Anthropic()
response = client.messages.create(
    model="claude-sonnet-4-20250514",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": f"Explain the equations in this document:\n\n{markdown}"}
    ]
)

Equation Numbering

Block equations are automatically numbered using LaTeX \tag{N} syntax:

With numbering (default):

$$
E = mc^{2} \tag{1}
$$

$$
F = ma \tag{2}
$$

Without numbering (equation_numbers=False or --no-equation-numbers):

$$
E = mc^{2}
$$

$$
F = ma
$$

Supported Math Elements

Element	LaTeX Output
Fraction	\frac{a}{b}
Superscript	x^{2}
Subscript	x_{i}
Radical	\sqrt{x}, \sqrt[n]{x}
Integral	\int_{a}^{b} f(x) dx
Summation	\sum_{i=1}^{n} x_i
Matrix	\begin{pmatrix}...\end{pmatrix}
Greek letters	\alpha, \beta, \gamma ...
Functions	\sin, \cos, \log, \lim ...
Brackets	\left(...\right)
Accents	\hat{x}, \vec{v}, \bar{x}

Multilingual Support

Full support for documents in any language:

Language	Support
Japanese (日本語)	✅ Hiragana, Katakana, Kanji
Chinese (中文)	✅ Simplified and Traditional
Korean (한국어)	✅ Hangul
Arabic (العربية)	✅ RTL text
Cyrillic (Русский)	✅ Russian, Ukrainian, etc.

Math symbols (α, β, ∑, ∫, etc.) are converted to LaTeX while preserving surrounding text.

Development

# Clone and setup
git clone https://github.com/manabelab/eqword2llm.git
cd eqword2llm
uv sync --dev

# Run tests
uv run pytest tests/ -v

# Lint and type check
uv run ruff check src tests
uv run mypy src

Comparison with Other Tools

Feature	eqword2llm	mammoth	pandoc
Math equations	✅ LaTeX	❌	△ Partial
Equation numbering	✅	❌	△
Zero dependencies	✅	❌	❌
LLM-optimized	✅	❌	❌
Unicode support	✅	✅	✅

Limitations

• Images are not currently supported
• Complex layouts (multiple columns, text boxes) are simplified
• Some special math symbols may not be converted

License

MIT License - See LICENSE for details.

Contributing

Issues and Pull Requests are welcome!