# Jb Markit

> Use when converting PDFs, Office/iWork docs, webpages, feeds, spreadsheets, JSON/YAML, GitHub pages, images, audio, archives, or stdin to markdown.

- Skill: `bjesuiter/jb-markit` (Agent Skill)
- Install (CLI): `npx skillmds@latest add bjesuiter/jb-markit`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bjesuiter/jb-markit/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: bjesuiter (https://skillmd.com/u/bjesuiter)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/bjesuiter/jb-markit

---


# jb-markit

Use `markit` to convert almost anything into markdown.

> Tested and adjusted against `markit 0.5.0`.

## Install

```bash
bun add -g markit-ai
```

## Best modes for agents

- `markit <source> -q` → raw markdown only
- `markit <source> --json` → structured output for parsing
- `markit <source> -o output.md` → write markdown to a file
- `markit <source> -i extracted-images/` → save extracted images to a directory
- `cat file.pdf | markit -` → read from stdin

## Quick start

```bash
# Documents
markit report.pdf
markit document.docx
markit slides.pptx
markit data.xlsx
markit proposal.pages
markit deck.key
markit budget.numbers

# Web
markit https://example.com/article
markit https://en.wikipedia.org/wiki/Markdown
markit https://github.com/user/repo
markit https://gist.github.com/user/abcdef

# Data / config
markit data.csv
markit config.json
markit schema.yaml

# Raw markdown or JSON
markit report.pdf -q
markit report.pdf --json

# Save output
markit report.pdf -o report.md
```

## Media + AI

Images and audio include metadata extraction by default. AI descriptions/transcriptions require an API key.

```bash
# OpenAI (default)
export OPENAI_API_KEY=sk-...
markit photo.jpg
markit recording.mp3

# Anthropic
markit config set llm.provider anthropic
export ANTHROPIC_API_KEY=sk-ant-...
markit photo.jpg

# Focus image description / extraction
markit receipt.jpg -p "List all line items with prices as a table"
markit whiteboard.jpg -p "Extract all text verbatim"
markit diagram.png -p "Describe the architecture and data flow"

# Save extracted images alongside markdown output
markit report.pdf -i ./report-images -o report.md
```

## Common formats

`markit` supports PDFs, DOCX, PPTX, XLSX, HTML, EPUB, Jupyter notebooks, RSS/Atom, CSV/TSV, JSON, YAML, XML/SVG, Pages, Keynote, Numbers, plain text, many code files, images, audio, ZIP archives, GitHub URLs, Wikipedia pages, and general URLs.

Use `markit formats` to see what the installed version supports.

## Config

```bash
markit init
markit config show
markit config get llm.model
markit config set llm.provider anthropic
markit config set llm.apiBase http://localhost:11434/v1
```

Config file: `.markit/config.json`

Env vars override config. Common keys:
- `OPENAI_API_KEY`
- `ANTHROPIC_API_KEY`
- `MARKIT_API_KEY`

## Onboarding

```bash
markit onboard
```

Adds markit usage instructions to `CLAUDE.md` or `AGENTS.md`.

## Plugins

```bash
markit plugin install npm:markit-plugin-dwg
markit plugin install git:github.com/user/markit-plugin-ocr
markit plugin install ./my-plugin.ts
markit plugin list
markit plugin remove dwg
```

Plugin converters run before built-ins, so plugins can add new formats or override existing converters.

## Good defaults

- Prefer `-q` when you want clean markdown in pipelines.
- Prefer `--json` when another tool or agent will parse the result.
- Use `-p` to constrain image description/extraction to the exact task.
- Use `-i` when you want extracted images written to a durable folder.
- Use `-o` when the conversion should become a durable artifact in the repo.