v1.5.1 to v1.6.0

7 added, 4 removed. Audit A to A.

---

name: pdf2mark

- version: "1.5.1"

+ version: "1.6.0"

description: Bash skill — run `pdf2mark <file.pdf>` in your shell (not an MCP tool). Convert PDFs to clean Markdown — local extraction, cloud-OCR fallback for scans. Use when the user wants a PDF as Markdown.

disable-model-invocation: true

---

# Skill: pdf2mark

```bash

pdf2mark document.pdf # That's it.

```

Converts PDFs to Markdown. The default auto-selects the converter: **pdfplumber** (local, free) first; for scans (no text layer) it **falls back to llamaparse** (cloud OCR — the document is uploaded to LlamaCloud, US). Token comes from `credgoo FETCH_URL_BEARER` (same credential as the fetch-url `api` tool).

+ **Default output:** `md/<name>.pdf.md` next to the PDF — `pdf2mark abd.pdf` writes `./md/abd.pdf.md` (the `md/` dir is created).

## Keep it simple

| ✗ Don't | ✓ Do |

|---------|------|

+ | `pdf2mark doc.pdf --out doc.md -v 2>&1` | `pdf2mark doc.pdf` |

| `pdf2mark scan.pdf --method llamaparse --tier fast --language de -v` | `pdf2mark scan.pdf` |

- | `pdf2mark doc.pdf --method pdfplumber --out doc.md -v 2>&1` | `pdf2mark doc.pdf --out doc.md` |

## Usage

```bash

- pdf2mark document.pdf # auto: pdfplumber, llamaparse fallback

+ pdf2mark document.pdf # → ./md/document.pdf.md (default: file next to the PDF)

pdf2mark scan.pdf --method llamaparse # force cloud OCR (scans, tables, multi-column)

- pdf2mark doc.pdf --out doc.md # write file (stats to stderr) instead of stdout

+ pdf2mark doc.pdf --out doc.md # explicit output file

+ pdf2mark doc.pdf --stdout # markdown to stdout instead of a file

```

Full options (llamaparse tiers, OCR language, timeout), size limits, error codes, credentials and the raw endpoint: **[references/api.md](references/api.md)**.

## Install

Ships in the **skale-skills** pi package. For a global `pdf2mark` shell command, run the installer from **this skill's own directory**:

```bash

./install.sh # → creates ~/.local/bin/pdf2mark (uv auto-installed)

```

**Other agents (zcode, etc.):** symlink this directory into the agent's skills dir — it reads the same `SKILL.md`:

```bash

ln -s "$(pwd)" ~/.zcode/skills/pdf2mark # agent-neutral: any skills dir works

```

## Update

```bash

pdf2mark --update # git pull + uv sync

pdf2mark --selfcheck # version + last update

```

Auto-updates in background every 7 days.