# markit-markdown-converter

This skill turns files, URLs, and media into Markdown through the markit-ai CLI or SDK. Use it when an agent needs readable content from source material.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 855 installs · ★ 88
- Author: reason-machines
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/reason-machines/trending-skills/tree/HEAD/skills/markit-markdown-converter/SKILL.md
- Updated: 2026-10-09
- HTML: https://affpapa.org/en/nevibecode/skills/markit-markdown-converter

## What it does

The skill gives an agent a way to use `markit-ai` for PDFs, Word and PowerPoint files, spreadsheets, HTML, EPUB, notebooks, feeds, structured data, images, audio, ZIP archives, URLs, and source code. Output can go to a file, JSON, stdout, or another command in a pipe.

Its CLI reads stdin, reports supported formats, and installs converter plugins. The TypeScript API exposes `Markit` methods for paths, URLs, and `Buffer` values. Configuration comes from `.markit/config.json`, while installed plugins can be loaded by the SDK.

Image descriptions and audio transcription need an OpenAI or Anthropic API key. Without one, the media metadata path still works, but those AI features do not.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill markit-markdown-converter -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill markit-markdown-converter -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill markit-markdown-converter -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/trending-skills markit-markdown-converter
```

2. **Manually: put the files in place**
- File: `.github/skills/markit-markdown-converter/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill markit-markdown-converter -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/reason-machines/trending-skills --path skills/markit-markdown-converter
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill markit-markdown-converter -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/reason-machines/trending-skills/tree/HEAD/skills/markit-markdown-converter/SKILL.md

## When to use it
- turn a PDF or DOCX into Markdown
- pull article content from a URL
- describe an image with an LLM
- transcribe an audio recording
- add a custom converter plugin

## Example prompts
- Convert `report.pdf` to Markdown and write the result to `report.md` with `markit`.
- Fetch `https://example.com/article` and return its content as clean Markdown.
- Use an LLM to describe `diagram.png`, including its architecture and data flow.

## Similar
- [grill-with-docs](https://affpapa.org/en/nevibecode/skills/grill-with-docs.md) — skill · 1219756 installs
- [skill-creator](https://affpapa.org/en/nevibecode/skills/skill-creator.md) — skill · 414180 installs
- [setup-matt-pocock-skills](https://affpapa.org/en/nevibecode/skills/setup-matt-pocock-skills.md) — skill · 1052851 installs
- [handoff](https://affpapa.org/en/nevibecode/skills/handoff.md) — skill · 1038491 installs
- [triage](https://affpapa.org/en/nevibecode/skills/triage.md) — skill · 990453 installs
- [domain-modeling](https://affpapa.org/en/nevibecode/skills/domain-modeling.md) — skill · 876391 installs

From the same set: [reason-machines/trending-skills](https://affpapa.org/en/nevibecode/by/reason-machines/trending-skills.md) — 139 cards

---
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