# Markit

> Markit is an Agent Skill for documents published in the Michaelliv/markit repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Convert files and URLs to Markdown. Supports PDF, DOCX, PPTX, XLSX, HTML, EPUB, CSV, JSON, GitHub URLs, images, audio, ZIP, and more. Use when you need to extract content from any document format.

- Skill name: `markit`
- Category: [Documents](https://www.openparable.com/skill/documents/1)
- Source: https://github.com/Michaelliv/markit/blob/HEAD/SKILL.md
- Repository: Michaelliv/markit (1,287 GitHub stars when collected)

## SKILL.md

# markit

Convert anything to Markdown.

## CLI

```bash
# Convert a file
npx markit-ai report.pdf -q

# Convert a URL
npx markit-ai https://en.wikipedia.org/wiki/Markdown -q

# GitHub URLs (repos, files, gists, issues, PRs)
npx markit-ai https://github.com/owner/repo -q
npx markit-ai https://github.com/owner/repo/issues/42 -q
npx markit-ai https://gist.github.com/user/id -q

# Write to file
npx markit-ai document.docx -q -o output.md

# See all options
npx markit-ai --help

# See supported formats
npx markit-ai formats
```

`-q` gives raw markdown. `--json` gives `{ markdown, title }`.

## SDK

```typescript
import { Markit } from "markit-ai";

const markit = new Markit();
const { markdown } = await markit.convertFile("report.pdf");
const { markdown } = await markit.convertUrl("https://example.com");
const { markdown } = await markit.convert(buffer, { extension: ".docx" });
```

---

Source: https://www.openparable.com/skill/documents/markit (OpenParable). Cite the canonical URL above.