# Markdown Everything

> Converts 20+ document formats (PDF, DOCX, XLSX, PPTX, images, audio) to Markdown. Invoke when user asks to convert documents, extract text from files, or transform formats to Markdown.

- **Type:** Skill
- **Install:** `agentstack add skill-wokaka209-markdown-everything-markdown-everything`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [wokaka209](https://agentstack.voostack.com/s/wokaka209)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [wokaka209](https://github.com/wokaka209)
- **Source:** https://github.com/wokaka209/markdown_everything/tree/main/SKILL/markdown-everything

## Install

```sh
agentstack add skill-wokaka209-markdown-everything-markdown-everything
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# markdown-everything

将 PDF、Word、Excel、PPT、图片、音频等 20+ 种文档格式转换为 Markdown，让 AI Agent 能直接读取文档内容。

## 触发条件

当用户要求以下操作时调用此技能：
- 将文档转换为 Markdown
- 读取/提取文档内容
- 批量处理文档
- 处理中文 PDF 乱码

**注意**：如果用户只是问"怎么用 markitdown"，先回答问题，不要直接触发转换。

## 支持的格式

| 类别 | 格式 |
|------|------|
| 办公文档 | `.pdf` `.docx` `.doc` `.pptx` `.ppt` `.xlsx` `.xls` `.csv` |
| 图片 | `.jpg` `.png` `.gif` `.bmp` (OCR) |
| 音频 | `.mp3` `.wav` `.ogg` `.m4a` |
| 网页/数据 | `.html` `.htm` `.json` `.xml` |
| 其他 | `.epub` `.azw3` `.zip` |

## 使用方法

### 第一步：环境准备

首次使用需安装依赖。根据操作系统选择对应命令：

**Windows (PowerShell)**：

```powershell
pip install "markitdown[all]"
pip install pdfplumber
```

如果使用 Conda：

```powershell
conda create -n markitdown python=3.12 -y
conda activate markitdown
pip install "markitdown[all]"
pip install pdfplumber
```

**Linux / macOS**：

```bash
pip install "markitdown[all]"
pip install pdfplumber
```

如果使用 Conda：

```bash
conda create -n markitdown python=3.12 -y
conda activate markitdown
pip install "markitdown[all]"
pip install pdfplumber
```

国内用户可使用镜像加速：

```powershell
pip install "markitdown[all]" -i https://pypi.tuna.tsinghua.edu.cn/simple
```

### 第二步：转换文档

**基本转换**：

```bash
python SKILL/markdown-everything/scripts/convert_document.py "输入文件.pdf" -o "输出.md"
```

或直接使用 markitdown CLI：

```bash
markitdown "输入文件.docx" -o "输出.md"
```

**Windows PowerShell 用户注意**：不要使用 `&&` 链接命令，请用分号 `;` 或分行：

```powershell
# 正确：分号链接
conda activate markitdown; markitdown "文档.pdf" -o "输出.md"

# 正确：分行
conda activate markitdown
markitdown "文档.pdf" -o "输出.md"

# 错误：&& 在部分 PowerShell 版本不可用
conda activate markitdown && markitdown "文档.pdf" -o "输出.md"
```

### PDF 中文文档特殊处理

PDF 文件会自动使用 `pdfplumber` 进行 Unicode 字符级提取，解决中文乱码问题。如果自动处理失败，会回退到标准 markitdown 转换。

### 高级选项

```bash
# JSON 格式输出
python SKILL/markdown-everything/scripts/convert_document.py "文档.docx" --json-output

# 详细日志
python SKILL/markdown-everything/scripts/convert_document.py "文档.docx" --verbose

# LLM 增强（需设置 OPENAI_API_KEY 或 ANTHROPIC_API_KEY）
python SKILL/markdown-everything/scripts/convert_document.py "文档.docx" --llm-client openai --llm-model gpt-4o -o "输出.md"
```

### 批量转换

**Windows PowerShell**：

```powershell
Get-ChildItem "C:\Documents\*.docx" | ForEach-Object {
    markitdown $_.FullName -o "$($_.DirectoryName)\$($_.BaseName).md"
}
```

**Linux / macOS**：

```bash
for f in /path/to/docs/*.docx; do
    markitdown "$f" -o "${f%.docx}.md"
done
```

## 故障排除

### 转换失败

| 错误 | 原因 | 解决方案 |
|------|------|----------|
| `ModuleNotFoundError: No module named 'markitdown'` | 未安装依赖 | `pip install "markitdown[all]"` |
| `No module named 'pdfplumber'` | PDF 处理依赖缺失 | `pip install pdfplumber` |
| `Unsupported format` | 文件格式不支持 | 检查文件扩展名是否在支持列表中 |
| `Permission denied` | 文件被占用或权限不足 | 关闭文件，或用管理员权限运行 |
| `FileNotFoundError` | 文件路径错误 | 使用绝对路径，检查文件名拼写 |

### 输出格式问题

| 问题 | 原因 | 解决方案 |
|------|------|----------|
| 表格错乱 | markitdown 对复杂表格支持有限 | 用 `--json-output` 获取结构化数据，或用 Excel 打开原文件 |
| 图片丢失 | markitdown 不提取图片 | 图片需要单独处理，用 OCR 工具提取文字 |
| 中文乱码 | 编码问题 | 确保安装 pdfplumber；用 VS Code 以 UTF-8 打开输出文件 |
| 链接失效 | 相对路径转换问题 | 检查原文件链接，手动修复 |

### 环境问题

| 问题 | 解决方案 |
|------|----------|
| conda 命令找不到 | 安装 [Miniconda](https://docs.conda.io/en/latest/miniconda.html)；Windows 用户使用 Anaconda Prompt |
| pip 安装超时 | 使用镜像源：`-i https://pypi.tuna.tsinghua.edu.cn/simple` |
| PowerShell 不支持 `&&` | 改用分号 `;` 连接命令，或分行执行 |

## 环境变量

| 变量 | 默认值 | 说明 |
|------|--------|------|
| `MARKITDOWN_ENV_NAME` | `markitdown` | Conda 环境名称 |
| `MARKITDOWN_PYTHON_VER` | `3.12` | Python 版本 |
| `MARKITDOWN_USE_PIP` | `false` | 设为 `true` 跳过 conda，使用系统 pip |
| `MARKITDOWN_PIP_MIRROR` | `default` | 镜像源（tsinghua/aliyun/douban） |
| `OPENAI_API_KEY` | — | GPT-4 增强转换 |
| `ANTHROPIC_API_KEY` | — | Claude 增强转换 |

## 注意事项

- 首次使用会自动检测并安装依赖
- PDF 中文文档优先使用 pdfplumber 处理
- 大文件转换可能需要较长时间
- LLM 增强功能需要 API Key
- 输出文件默认保存在输入文件同目录
- Windows 用户：路径中包含空格时，用引号包裹路径

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [wokaka209](https://github.com/wokaka209)
- **Source:** [wokaka209/markdown_everything](https://github.com/wokaka209/markdown_everything)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-wokaka209-markdown-everything-markdown-everything
- Seller: https://agentstack.voostack.com/s/wokaka209
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.