| name | markdown-tools |
| description | Converts documents to markdown with multi-tool orchestration for best quality. Supports Quick Mode (fast, single tool) and Heavy Mode (best quality, multi-tool merge). Use when converting PDF/DOCX/PPTX files to markdown, extracting images from documents, validating conversion quality, or needing LLM-optimized document output. |
| zh_description | 用于Markdown、tools，支持文档、表格、演示和资料整理。 |
| version | 1.0.0 |
| author | seaworld008 |
| source | in-house |
| source_url | |
| tags | ["markdown", "tools"] |
| created_at | 2026-03-04 |
| updated_at | 2026-03-20 |
| quality | 4 |
| complexity | intermediate |
Markdown Tools
Convert documents to high-quality markdown with intelligent multi-tool orchestration.
When to Use
Use this skill when the user wants to:
- convert PDF, DOCX, PPTX, or XLSX into Markdown
- extract images alongside Markdown output
- compare multiple converters for quality
- validate a conversion before downstream LLM use
Usage
Recommended flow:
choose quick or heavy mode
-> convert with best-fit tool(s)
-> validate output quality
-> extract images if needed
-> merge or refine outputs
Dual Mode Architecture
| Mode | Speed | Quality | Use Case |
|---|
| Quick (default) | Fast | Good | Drafts, simple documents |
| Heavy | Slower | Best | Final documents, complex layouts |
Quick Start
Installation
uv tool install "markitdown[pdf]"
pip install pymupdf4llm
brew install pandoc
Basic Conversion
uv run --with pymupdf4llm --with markitdown scripts/convert.py document.pdf -o output.md
uv run --with pymupdf4llm --with markitdown scripts/convert.py document.pdf -o output.md --heavy
uv run scripts/convert.py --list-tools
Tool Selection Matrix
| Format | Quick Mode Tool | Heavy Mode Tools |
|---|
| PDF | pymupdf4llm | pymupdf4llm + markitdown |
| DOCX | pandoc | pandoc + markitdown |
| PPTX | markitdown | markitdown + pandoc |
| XLSX | markitdown | markitdown |
Tool Characteristics
- pymupdf4llm: LLM-optimized PDF conversion with native table detection and image extraction
