# office-to-md

office-to-md turns Office documents and PDFs into Markdown files while keeping tables and images. Ideal when an agent needs to read spreadsheets, slide decks, or text files.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 1 install · ★ 277 repo stars
- Author: shuyu-labs
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/shuyu-labs/WebCode/tree/HEAD/skills/claude/office-to-md/SKILL.md
- Updated: 2026-06-20
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/office-to-md

## What it does

The skill uses Python scripts to translate DOCX, XLSX, PPTX, and PDF files into structured Markdown. It recognizes heading hierarchies, extracts inline pictures, and formats spreadsheet grids into Markdown tables. You can serve extracted graphics via a local directory or a custom URL.

Processing legacy DOC files strictly requires a working LibreOffice installation on your machine. Without LibreOffice, the companion script `doc_converter.py` fails immediately. Table parsing in PDF files offers two approaches: fast boundary detection with lines or precise detection based on text coordinates.

The parser handles individual files up to 160MB in size.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add shuyu-labs/WebCode --skill office-to-md -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/office-to-md/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/office-to-md/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add shuyu-labs/WebCode --skill office-to-md -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/office-to-md/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add shuyu-labs/WebCode --skill office-to-md -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/office-to-md/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install shuyu-labs/WebCode skills/claude/office-to-md
```

2. **Manually: put the files in place**
- File: `.github/skills/office-to-md/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add shuyu-labs/WebCode --skill office-to-md -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/shuyu-labs/WebCode --path skills/claude/office-to-md
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/office-to-md/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add shuyu-labs/WebCode --skill office-to-md -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/shuyu-labs/WebCode/tree/HEAD/skills/claude/office-to-md/SKILL.md

## When to use it
- turn spreadsheet sheets from Excel into Markdown tables
- extract text and graphics from PowerPoint presentations
- convert complex PDF documents while preserving headings
- transform legacy Word DOC files into clean text

## Example prompts
- Convert `specification.docx` into Markdown and export its images
- Transform the `budget.xlsx` sheets into Markdown tables
- Parse `deck.pptx` into Markdown while keeping slide order

## Similar
- [office-productivity](https://affpapa.org/en/nevibecode/skills/office-productivity.md) — skill · 1600 installs
- [docs-router](https://affpapa.org/en/nevibecode/skills/docs-router.md) — skill · 138 installs
- [office](https://affpapa.org/en/nevibecode/skills/office.md) — skill · ★ 171 repo stars
- [markitdown](https://affpapa.org/en/nevibecode/skills/markitdown.md) — skill · 2400 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
