Doc to Markdown
Converts DOCX, PDF and PPTX files into clean Markdown with eight automatic post-processing fixes.
Docs & OfficeIntermediate★ 1,323⑂ 212AI score 10/10Last updated: Aug 8, 2026
What it does
- Converts DOCX / PDF / PPTX / XLSX to Markdown, picking the best tool per format (pandoc, pymupdf4llm, markitdown).
- Applies eight automatic DOCX cleanups: broken grid/simple tables, nested
media/media/image paths, leftover{width=...}attributes, escaped brackets, double-bracket links, and indented code blocks. - Fixes CJK bold rendering by inserting whitespace around
**spans that contain CJK characters. - Offers Quick mode (fast) and Heavy mode (runs tools in parallel, scores segments, merges the best table/image/heading versions).
- Ships validation tooling that measures text/table/image retention and can emit an HTML report, plus a PDF image extractor with metadata.
Who it's for
- Technical writers moving Word/PDF material into wikis or Git repos.
- Anyone handling Chinese/Japanese/Korean documents plagued by bold and table glitches.
- Engineers preparing document corpora for RAG or LLM pipelines.
Example uses
- "Convert spec.docx to markdown" → clean
.mdwith images extracted to./media. - "Pull every figure out of this PDF" →
extract_pdf_images.pyoutputs images plus a metadata JSON. - "Did the conversion lose anything?" →
validate_output.pyproduces a pass/warn/fail retention report.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/daymade/claude-code-skills/HEAD/daymade-docs/doc-to-markdown/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the daymade-docs/doc-to-markdown folder from the GitHub repo daymade/claude-code-skills into my ~/.claude/skills/doc-to-markdown/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/daymade/claude-code-skills.git && mkdir -p ~/.claude/skills && cp -r claude-code-skills/daymade-docs/doc-to-markdown ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal.
- Clone the repo:
git clone https://github.com/daymade/claude-code-skills.git - Copy the skill into place:
mkdir -p ~/.claude/skills && cp -r claude-code-skills/daymade-docs/doc-to-markdown ~/.claude/skills/ - Install the converters:
brew install pandoc(orapt install pandoc),pip install pymupdf4llm,uv tool install "markitdown[pdf]" - If
uvis missing, install it first:curl -LsSf https://astral.sh/uv/install.sh | sh - Restart Claude Code and say "convert this document to markdown" to trigger the skill.
- Optional sanity check:
uv run --with pytest pytest ~/.claude/skills/doc-to-markdown/scripts/test_convert.py -v
View source on GitHub ↗License: MIT