Claude Skill MartBrowse skillsQuick linesLearn by videoTerminal guideWhat is a Skill?
Back to list

Doc to Markdown

Converts DOCX, PDF and PPTX files into clean Markdown with eight automatic post-processing fixes.

Docs & OfficeIntermediate1,323212AI 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

  1. "Convert spec.docx to markdown" → clean .md with images extracted to ./media.
  2. "Pull every figure out of this PDF" → extract_pdf_images.py outputs images plus a metadata JSON.
  3. "Did the conversion lose anything?" → validate_output.py produces 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)
  1. Download the ZIP with the button below.
  2. In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
  3. Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Download 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.

  1. Open a terminal.
  2. Clone the repo: git clone https://github.com/daymade/claude-code-skills.git
  3. Copy the skill into place: mkdir -p ~/.claude/skills && cp -r claude-code-skills/daymade-docs/doc-to-markdown ~/.claude/skills/
  4. Install the converters: brew install pandoc (or apt install pandoc), pip install pymupdf4llm, uv tool install "markitdown[pdf]"
  5. If uv is missing, install it first: curl -LsSf https://astral.sh/uv/install.sh | sh
  6. Restart Claude Code and say "convert this document to markdown" to trigger the skill.
  7. Optional sanity check: uv run --with pytest pytest ~/.claude/skills/doc-to-markdown/scripts/test_convert.py -v