How do I install the Word2md skill?

Run npx skillmds@latest add phanghonghao/word2md in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Word2md skill do?

Convert Word (.docx) files with Office Math formulas to clean Markdown with LaTeX. Handles OMML to LaTeX conversion, Greek letters, subscripts, superscripts, fractions, and display/inline math. It is listed under Docs & Writing on SkillMD.

Is Word2md safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Word2md?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Word2md free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Word2md?

phanghonghao (@phanghonghao) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Word2md by phanghonghao — Agent Skill

Name: Word2md
Author: phanghonghao

File contents

Word to Markdown Converter

Convert Word (.docx) files containing Office Math (OMML) formulas to clean Markdown with LaTeX math.

When to Use

User says "convert docx to md", "word to markdown", "word2md"
User provides a .docx file and wants it in Markdown format
User needs to extract math formulas from Word documents

How to Use

PYTHONIOENCODING=utf-8 python ~/.claude/skills/word2md/word2md.py "<input.docx>" ["<output.md>"]

input.docx (required): Path to the Word file
output.md (optional): Output file path. If omitted, prints to stdout

Examples

# Convert and print to stdout
PYTHONIOENCODING=utf-8 python ~/.claude/skills/word2md/word2md.py "document.docx"

# Convert and save to file
PYTHONIOENCODING=utf-8 python ~/.claude/skills/word2md/word2md.py "document.docx" "output.md"

Features

OMML to LaTeX: Converts Office Math XML elements (subscripts, superscripts, fractions, square roots, delimiters, sums/integrals, accents, limits, functions)
Unicode to LaTeX: Greek letters (alpha, beta, sigma...) and math symbols (geq, times, circ...)
Display vs inline math: oMathPara produces $$...$$, oMath produces $...$
Post-processing: Cleans up delimiter issues, fixes command spacing, bold headers

Dependencies

python-docx must be installed: python -m pip install python-docx

Frequently asked questions

Word2md