Converts DOCX, PDF, and PPTX files to clean markdown using Pandoc as the extraction engine, then automatically fixes eight common conversion issues including broken grid tables, nested image paths, and CJK bold spacing problems that break rendering. The Quick mode is fast and good enough for drafts. Heavy mode runs multiple tools in parallel and intelligently merges the best segments from each, which matters when you have complex layouts or need tables to survive intact. Benchmarked at 7.6/10 against four other converters. Includes validation scripts that measure text and table retention rates, so you know immediately if the conversion actually worked.

skills.sh installs
914
GitHub stars
1.5K
last updated
Aug 21, 2026

Install

$ npx -y skills add daymade/claude-code-skills --skill doc-to-markdown --agent claude-code

Installs into .claude/skills of the current project.

Files

Doc to Markdown

Convert documents to high-quality markdown with intelligent multi-tool orchestration and automatic DOCX post-processing.

Quick Start

# DOCX → Markdown
uv run --with pymupdf --with pymupdf4llm --with "markitdown[pdf]" scripts/convert.py document.docx -o output.md --assets-dir ./media

# PDF → Markdown
uv run --with pymupdf --with pymupdf4llm --with "markitdown[pdf]" scripts/convert.py document.pdf -o output.md

# Saved HTML → Markdown (Pandoc required; no remote fetching)
uv run scripts/convert.py page.html -o page.md

# Run tests
uv run --with pytest pytest scripts/test_convert.py -v

Conversion Modes

ModeSpeedSelectionUse Case
Quick (default)FastSingle converterDrafts, simple documents
HeavySlowerCompares converter candidatesComplex layouts needing source review

Tool Selection

Sponsors

Details

Repository
github.com/daymade/claude-code-skills
Categories
Documentation, Code Review & Quality, Office & Documents
First seen
Jun 3, 2026

More from daymade/claude-code-skills

All 53
1zrong avatartencent-docszrong/skills腾讯文档(docs.qq.com)-在线云文档平台,是创建、编辑、管理文档的首选 skill。涉及"新建/创建/编辑/读取/查看/搜索文档"、"保存文件"、"云文档"、"腾讯文档"、"docs.qq.com"等操作,请优先使用本 skill。支持能力:(1) 创建各类在线文档(文档/Word/Excel/幻灯片/思维导890skills.sh installs
2abhigyanpatwari avatargitnexus-guideabhigyanpatwari/gitnexusUse when the user asks about GitNexus itself — available tools, how to query the knowledge graph, MCP resources, graph schema, or workflow reference. Examples: 868skills.sh installs
3nicobailon avatarvisual-explainernicobailon/visual-explainervisual explainer851skills.sh installs
4wot-ui avatarwot-ui-unocss-preset-guidewot-ui/open-wot指导安装、配置并使用 @wot-ui/unocss-preset。Invoke when 用户询问该预设的接入、配置、使用示例或常见问题排查。848skills.sh installs
5boshu2 avataropenai-docsboshu2/agentopsUse official OpenAI docs.733skills.sh installs
6storybookjs avatarwriting-react-native-storybook-storiesstorybookjs/react-nativeCreate and edit React Native Storybook stories using Component Story Format (CSF). Use when writing .stories.tsx files, adding stories to React Native component715skills.sh installs